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Develop faster. Compile 
faster. Debug faster. Realize 
your Java™ dreams faster. 


# Symantec, the creator of 
~ the first full-featured Java 
development environment, now unleashes 
the first Rapid Application Development 
environment for Java developers: 


Symantec Visual Café” 


Visual Café comes complete with an 
extensible component library with all of the 
building blocks you need for your application. 


Simply drag and drop a component 
onto a form. Our Interaction Wizard 
lets you visually specify all the actions 
and events. And then Visual Café 
automatically generates the Java 
code for you. 


Thanks to our exclusive two-way 
programming you can add or modify 
the code at the source level, too. 


So you'll be whipping out those 
application prototypes at speeds 


you can only dream of now. Microsotts 
Windows’95 


Imagine building all of your forms 
visually. Or building your entire user interface 
without writing one single line of code! 


As an added bonus, Symantec's Just In 
Time (JIT) compiler (included in Netscape’s 
new Navigator™) runs your Java applications 
faster than any other browser or Java 
virtual machine on the planet. 


So get your hands on the hottest new 


Visual Café for Macintosh’ and Windows: development tool for Java right away. 


For more information, call us at 
1-800-453-1059 ext. 9H29 or visit our 
Web site at cafe.symantec.com. Or 
pick up a copy at Fry’s, MicroCenter, 
CompUSA or Egghead. 
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Behind every goo 


Every job requires the proper tool. When it 
comes to crafting good code, BBEdit 4.0 is 
the Swiss Army Chainsaw of text editors. 


"If you have to spend time with text 
on the Mac, you should use BBedit." 


-- MacWeek, September 30, 1996 


¢ Compare source files and 
apply differences 


¢ Open From and Save To FTP 
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¢ Search and replace multiple files 
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e Navigate source files with integrated 
PopupFuncs™ technology 


¢ Browse project documents 





Bungie Software's Marathon Infinity, created using BBEdit. 
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Seurce code from Marathon Infinity displayed in BBEdit. 
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Bare Bones Software, Inc. 


Pees PO. Box 1048, Bedford, MA 01730 © main 617-778-3100 © fax 617-778-3111 
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In this electronic age, the art of 


communication has become both easier and 
more complicated. Is it any surprise that we 


prefer e-mail? 


If you have any questions, feel free to call us 
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By Eric Gundrum 


ere 


Just How Easy Is Ir? 


With all this talk of a modern OS for Macintosh, I am 
becoming concerned that we may be forgetting what made 
Macintosh so successful in the first place. Sure, we have many 
state-of-the-art, interesting technologies, but the single most 
defining attribute of a Mac is that it is so easy to use it is fun. 

Unfortunately, as Apple piles on new technologies, our Macs 
become less easy to use. I find that I, like many users, spend a 
significant amount of time configuring and tweaking our systems 
to make them work better, or keep them working. 

Everyone says this will be fixed in the new OS, Rhapsody, 
but I don’t think Rhapsody will be the second coming for the 
Macintosh world. No operating system, including NEXTSTEP, is 
as easy to use as the MacOS. No other OS truly supports plug and 
play at its core. With many years of brain drain, has Apple’s ease- 
of-use expertise drained away? 


What’s in a name 

Do you recall the origin of the name “Finder”? The Finder 
was so named because, when we double clicked a document, 
the Finder located the application that created the document and 
use it to open the document. Macintosh users seem to take this 
for granted, but no other OS does this, even today. All other 
Operating systems rely on filename extensions such as ‘txt’ and 
search paths which tell the OS in what directories to look for 
applications. This capability of the Finder was a big revolution in 
ease of use since the advent of personal computers: possibly 
even bigger than graphical interfaces. 

What the Finder does for applications is very much like the 
plug the play capabilities of Macintosh hardware. Just drop a new 
application on a disk, and it is ready to use, no configuration 
required; at least, that’s the way it used to be. 


Plug and play software 

Over the years Apple’s plug and play approach to software 
has eroded. Some software, such as OpenDoc part editors, Apple 
Guide files, and system extensions, must be placed on the 
appropriate “command path” for the OS to find and activate 
them. If that description sounds a bit DOS-like, that’s because it 
is. DOS and Windows require the “PATH” variable contain a list 
of directories to search for applications; so does UNIX. 

Application developers are no better. Many applications won't 
run if their necessary files aren’t found in the Preferences folder, or 
some other part of the Mac that doesn’t belong to them. 

What ever happened to plug and play? What ever happened 
to this being my Macintosh, configured the way I like it, with files 
organized in a way that makes sense to me? 
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Make it easier 

I'd like to see Apple assign some engineering and design 
resources to making the Mac easy to use again. The rumors 
I've heard about the upcoming MacOS releases are not 
encouraging. The idea that I will have to use a multi-button 
mouse, or control-option-command-click, is horrendous. It 
makes sense as a little-used menu short-cut, but not as the 
primary interface. 

Printers should be plug and play. If I connect another 
printer to my Mac, it should automatically appear as a choice in 
the Print dialog; even if it is a serial-based printer. Forget the 
Chooser, and forget other configuration files. I want it to just 
work so I don’t waste any more time on the phone talking my 
friends through setting up their Macs. 

Most of all, I want a plug and play file system. If Apple 
were to design a system-level mechanism to link all files sharing 
the same signature, we could have some significant 
improvements. When I trash an application, the Finder could 
automatically delete all support files related to the application, 
or it could warn me if I still have documents that require that 
application, and it could warn me to not trash any necessary 
support files. Application developers could keep their stuff out 
of my System Folder if the OS would automatically find the files 
for the application. OpenDoc part editors, or even fonts, could 
be placed on any volume and still be found by the OS. Gosh, it 
would be so Mac-like. 

Has the ease-of-use of the Macintosh degraded in these 
past thirteen years? On balance, probably not, but overall it 
doesn’t seem to have improved much. Apple certainly has their 
work cut out for them to bring this new OS to market. I hope 
they don’t lose sight of how important ease-of-use and plug- 
and-play has been to the success of the Macintosh and will be 
to its continued survival. 


SO LONG OLD FRIEND 

For many years Symantec’s Top Ten has been a part of 
MacTech Magazine. Through this column, Symantec’s support 
staff have provided us with tips and suggestions to help us get 
the most out of Symantec’s development tools. With the 
emergence of the Internet as such a strong vehicle for 
communicating with customers, we found it difficult to keep the 
Symantec Top Ten filled with timely information, After many 
years of service, we bid adieu to the Symantec Top Ten column. 
This will be its last issue. We are working with the Symantec staff 
in hopes to find new ways to provide you with more interesting 
information from this long-standing Macintosh developer tools 
publisher. Thank you, Symantec. 
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advanced security, compatibility and 
flexibility into a compact and end-user- 
friendly dongle. 


Grow With Aladdin! 
The fastest growing company 
in the industry, with over 4 
million keys sold to 20 
thousand developers 
worldwide, Aladdin is setting 
the standard for software security today. 


MacHASP Packs 

More Into Less. 

Based on state-of-the-art ASIC technology, 
MacHASP packs the industry’s most 











MacOS 


These days, more and more developers are choosing to protect their software against 
piracy. They’ re protecting more products, on more platforms, with better protection — 
and selling more as a result. 


And more of these developers are protecting with MacHASP. Why? 
Because MacHASP offers more security, more reliability and more 
features than any other product on the market. Only MacHASP offers 






NSTL Study Rates capabilities such as network support, anti-debugging envelope : 
HASP No.1! protection, and secure remote activation and updating. 

A recent tes* conducted by the National MacHASP supports the most advanced platforms, including all 

Software Testing Labs’, the world’s foremost versions of MacOS and Power Mac — as well as AppleTalk 

independent lab, compared the flagship PC networks. And because Aladdin is a licensed Apple Partner, 
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overall winner - and number one in all the everything you need to protect your 
major comparison categories. For a full copy To learn more about how you can protect software today! 
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A First Look at Objective-C 





Well it finally happened. Apple made 
their OS decision, catching many of us by 
surprise. Personally, I am very excited by 
Apple’s move. As was clear from the energy 
at Macworld Expo, things are finally 
moving. Apple has made a bold move. 
Now we have to retool and rethink our 
programming strategies. 

As Apple made clear, the System 7.5 
version of the Mac Toolbox still has some 
significant legs and will likely be part of our 
lives for some time to come. As I write this, 
the announced release schedule for 
Rhapsody (code name for the new OS) 
does not show a significant beta in our 
hands until January of next year. Nothing to 
complain about there. Of course, it will 
take time for Apple to marrv their 
technology to that of NeXT and we all want 
this job done right. 

My point is that there are some 
important decisions we all have to make, but 
the current schedule gives us the luxury of 
continuing down the current path (System 
7.5 apps) without penalty, while giving us 
the time to plan for the new order. 


WHAT ABOUT BE? 

Before we move on to the main focus 
of this column, I’d like to take a second to 
talk about the apparent loser in the OS 
wars: Be, Inc. You might think that 
because Be was not able to work out a 
deal with Apple, they have become 
damaged goods. Not so! As anyone who 
attended the first ever Be developer’s 
conference will tell you, the BeOS és cool, 
the commitment from developers is there, 
and there’s an excitement in the air, a 
feeling of being in on the ground floor of 
something big. 
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Bottom line, we now have two technological evolutions to 
follow. Things are about to get very interesting. 


JAVA, C, C++, AND PASCAL vs. OBJECTIVE-C 

There are a number of questions raised by Apple’s 
acquisition of NeXT. (See this month’s Factory Floor interview 
with Avie Tevanian, Apple’s new OS boss.) Among them, in what 
programming language will Rhapsody development be done? Is 
Objective-C the new sheriff in town? Will we be able to continue 
our C/C++ and Pascal efforts? And what about Java? 

AS we go to press, these issues are still not finalized. The 
story so far seems to be “all of the above.” Objective-C is the 
language for NEXTSTEP, and should provide the most intimate 
access to Rhapsody. So far, it looks like C, C++, Pascal, etc. will 
all be supported, though in a slightly more distant relationship. 
Objective-C and Java support dynamic binding. C and Pascal 
support static binding, and C++ supports late binding. 

In a nutshell, binding connects a called function to the 
function caller. Static binding means that the function being 
called is determined as the program is compiled. Though you can 
use function pointers to delay binding decisions in C, typically 
your binding decisions are made when you compile. 

Dynamic binding is the opposite of static binding. The 
binding decision is delayed until runtime. This allows you to add 
components to your program while it is still running. If the 
runtime environment is designed to support this (and Rhapsody 
should be), it opens up a lot of interesting possibilities. 

The C++ language supports a limited version of dynamic 
binding called late binding. In C++, a function call must type- 





Regular visitors to my web site may have noticed a | 
_ dramatic change over the last few months. The site has been 
reorganized (thanks to my brother Stu!) and lots of new stuff. 
has been added (like the long-requested updates of the 
Primer 2 code). Point your browser to: —rti—‘__—h 









<http://www.spiderworks.com> 


Drop me a line and let me know what you think... 
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match exactly the called function (called static typing) or else 
type-match exactly an inherited function. Though C++ virtual 
functions allow you to delay the binding until runtime, the type 
constraints still apply. Late binding is still restricted. Dynamic 
binding is unconstrained. 

Java uses the same binding mechanism as Objective-C. Java 
offers the advantage of being a cross-platform solution, as well as 
tightly integrated with the Internet. It seems likely that Java will 
continue to grow and is likely to play a large role in Rhapsody. 

What does all this mean for you? If you’ve been following 
this column over the past few months, you’ve already gotten a 
handle on Java. Over the next few months, we'll dig into 
Objective-C, starting with a review of some object programming 
terminology and a first look at the language syntax. 

Finally. you can call the NeXT order desk at 800-TRY-NEXT 
(800-879-6398) to order books, manuals and software directly 
from NeXT including “OpenStep Object-Oriented Programming 
and the Objective-C Language”, “Enterprise Objects Framework 
Developers Guide (for EOF 2.0)”, “Working with Interface 
Builder (for Enterprise Objects Framework)”, and “Discovering 
OPENSTEP. A Developer Tutorial (for Windows NT).” 


SOME OBJECT PROGRAMMING TERMINOLOGY 

Before we move on to the basics of Objective-C syntax, let’s 
review a bit of object programming terminology, just to make 
sure we are all on the same page. We've already talked about 
dynamic, static, and late binding. Here are a few more. 

Instanees, methods, and instance variables. Just as in C++, 
an Objective-C class definition is a template for the creation of 
individual objects, also known as instances. The functions within 
a class (member functions) are known as methods, and the 
variables (data members) are known as instance variables. 


Messages 

In C++, an object’s member function gets called. In 
Objective-C, a message is sent to an instance, known as the 
receiver. At runtime, the appropriate receiver method capable of 
handling the message is determined and the method is called. 


Interface, implementation, and encapsulation 

The interface to a class is the set of external methods 
defined for that class. The implementation is the internal 
workings of the class. The idea here is to keep the inner 
workings hidden from the user of a class, forcing them to 
access an instance via its interface. This mechanism is known 
as encapsulation. In Objective-C, all instance variables are 
encapsula‘ed and access to them is limited to methods defined 
for the class. 


Inheritance 

Inher tance in Objective-C works pretty much as it does in 
C++. The parent class is known as a superclass and derived 
classes are known as subclasses. 
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A First LOOK AT THE OBJECTIVE-C LANGUAGE 
Objective-C starts off with all the standard syntax of C. 
Objective-C source code files use the extension “.m”, while 
header files stick with the extension “.h”, 
Objective-C features a generic object pointer type called id. 


id myObject; 


An id is designed as a generic pointer to an object’s 
instance variables. The previous line of code didn’t actually 
allocate an object. It created a pointer which will eventually be 
used to allocate the object. nil is defined as an id with a value 
of 0. 

By using a generic object pointer type, Objective-C delays 
the type binding decisions until run time. This is a good thing, 
but it also puts a bit of extra overhead on the run-time system. 
Basically, in the NeXT world, all objects are derived from the root 
class Object. Object features an isa variable which is inherited by 
all Object subclasses (which should be all classes in your 
program). The isa instance variable specifies the class to which 
the object belongs. 

Earlier, we talked about the separation of interface and 
implementation. In Objective-C, you declare the classes interface 
like this 


@interface MyClass : MySuperClass 


instance variable declarations 


method declarations 
@end 


Objective-C supports the standard C compiler directives 
that start with “#”. In addition, Objective-C adds Objective-C 
specific compiler directives which start with “@”. As you might 
expect, class names start with an upper case letter and variable 
names with a lower case letter. By convention, all identifiers are 
named using intercaps, yielding names like myVariable and 
MyClass. 

Instance variable declarations are done just as they are in C 
and C++, though the type “id” is used pretty frequently in 
Objective-C and, obviously, is not built in to C or C++. 

Method declarations are pretty funky. Here’s a sample: 


- (int) getX: (int)x andY: (int)y; 


The leading minus sign marks this function as an instance 
method. A leading plus sign (“+”) marks the method as a class 
method. (A class method is sort of like a static method in C++. 
We'll talk about class objects and class methods in a future 
column.) 

The return type is specified in parentheses, just as if it were a 
typecast. If you leave off the return type, it defaults to the type id 
(just as a C function defaults to int if you leave off the return 
type). Note that a function that is not a method still defaults to a 
return type of int. | 
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The name of the method specified above is getX:andY: and 
includes the colons in the name. Weird, eh? The idea is to have 
each chunk of the method end with a colon and correspond to a 
parameter. In this case, there are two parameters, x and y. The 
type of each parameter is also specified by a typecasting-like 
mechanism. Both x and y are ints. 

Here’s another example: 


~ getObjl:objectl andObj2:object2; 


Note that this time all the type information was left out of the 
declaration. The return type and type of both arguments are the 
same, the default type “id”, 

Here’s a sample class interface: 


#import “Object .h” 
@interface MyClass : Object 
{ 

id myVar; 


= anit; 
- getLastObject:lastObject; 
@end 


This interface declares a class named MyClass derived from 
the class Object. MyClass features a single variable, an ic named 
myVar, and two methods, one named init and one named 
getLastObject, both of which return an id. 

Note that the interface, which lives in a “.h” file, starts off 
with a #import compiler directive. #import replaces the #ifdef 
business you use in C++ to make sure you don’t inc_ude an 
include file twice. Use #import to include any header files you 
need to include. Alternatively, you can just declare the classes 
you reference using the @class directive. 


@class Object; 


This directive tells the compiler that Object is a class. That’s 
it. This delays any type analysis until run-time and can solve 
some knotty cross-dependancy problems where classes refer to 
each other. Bottom line, use the @class directive if you can get 
away with it, otherwise #import the classes’ header file. 

The implementation of a class looks like this: 


@implementation MyClass : MySuperClass 


instance variable declarations 


method definitions 
@end 


Gee, doesn't this look familiar? Yup, the implementation looks 
almost identical to the interface. The differences? The 
implementation lives in a “.m” file instead of in a “h” file and the 
method definitions replace the method declarations in the 
interface. Also, you are required to #import your classes’ interface 
file in the implementation file. One nice benefit of this last fact is 
that you can leave the superclass and the instance variable 
declarations out of the implementation. 


Ei A First LOOK AT OBJECTIVE-C 


Here’s another look: 
import “MyClass.h” 


@implementation MyClass 
method definitions 
@end 


Tat NEXT MONTH... 


Hopefully, you’ve got a feel for the basic structure of an 
Objective-C program. Next month, we'll talk about message 
receivers and message syntax, and present our first Objective-C 
program. To get a head start, check out the Objective-C 
specification on the NeXT web site. (See the URL earlier in the 
column.) You can buy the NEXTSTEP environment running 
under NeXT, WinNT, and on top of Mach. Also, you might want 
to check out CodeBuilder from Tenon InterSystems. CodeBuilder 
runs on a Mac and comes with (among a LOT of other stuff) an 
Objective-C compiler. You might also want to check out Apple’s 
web site to find out the current release schedule for Rhapsody 
tool betas and the Metrowerks web site to find the status of their 
Rhapsody tools. & 
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e Improved hypertext and new THINK™ Reference Viewer 2.2 

e 100+ MBs of source code 

e Full version of THINK Reference 2.0 
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By Steve Wilson, Palo Alto, CA 








Building a Visual Programming Language 





Designing and 
implementing intelligent, 
user-friendly, commercial 
software with Prograph 





Back in late 1993, my business partner 
(and father) Dave Wilson and I decided we 
were going to create a new Macintosh 
application. We wanted to build an app that 
would appeal to a wide range of users and 
would fill a real need in the Mac 
community. We decided we would write a 
spreadsheet — but not just any 
spreadsheet. We locked ourselves in a 
conference room with a white board for 
two days, and designed a visual 
programming language (VPL) for solving 
the same type of problems typically solved 
with a spreadsheet. The product which 
resulted was called Let’s Keep It Simple 
spreadsheet (or L.K.I.S.S. for short). 
L.K.LS.S. 1.0 was first released in May 1996, 
and was very well received. In January 
1997 we released version 2.0 of the product 
and changed the name to Spreadsheet 
2000. 

In this article I will give an overview of 
the VPL we created and also talk briefly 
about our experiences implementing it. We 
used Prograph CPX, another VPL to write 
Spreadsheet 2000, and as you can imagine, 
this led to some interesting experiences. 


The old way vs. the new way 

A spreadsheet is a type of programming language. It just 
isn’t a good one! Anyone who has ever built a non-trivial 
spreadsheet knows how hard it is to do without causing unseen 
errors. One of the fundamental problems with spreadsheets is 
that your formulas, labels, and data are all mixed together. In 
fact, a single cell often contains a text-based formula hidden 
underneath the answer produced by the formula, as shown in 
Figure 1. 








Figure 1. Cell A4 looks like data, but it is actually a formula. 


We set out to design a Macintosh-like user interface to fix 
this and other problems with the traditional spreadsheet 
metaphor. Spreadsheet 2000 is the program we built. Figure 2 
shows a simple calculation done with Spreadsheet 2000 as it 
would appear on your screen. 





Figure 2. The same calculation done with Spreadsheet 2000. 


Sa aan cme ee 


Steve Wilson is a partner in Emergent Behavior, a small software company in Palo Alto, CA. He serves as the Lead Developer 
for Spreadsheet 2000, a new product being published by Casady & Greene, Inc. Steve can be reached at <steve@emer.com>. A 
demo version of Spreadsheet 2000 can be obtained through Casady & Greene’s web site at <http://www.casadyg.com> or 
Emergent Behavior’s site at <http://www.emer.com/s2k>. 
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Spreadsheet 2000 calculations are easy to understand 
because you can see what you’re doing. We use visible operators 
instead of text-based formulas to perform the work. We feel that 
this will lead to more accurate results, as well as a shallower 
learning curve. Lastly, we hope that Spreadsheet 2000 makes 
problem solving more fun. 





Figure 3. A screen shot of Spreadsheet 2000. 


LANGUAGE OVERVIEW 


Is Spreadsheet 2000 really a spreadsheet? I get asked that 
question a lot, and I’m not sure I know the answer. It probably 
isn’t, but it helps the marketing people to call it one. I can, 
however, tell you what Spreadsheet 2000 is: Spreadsheet 2000 is 
an object-based, data flow, visual programming language. I 
hesitate to say that Spreadsheet 2000 is object oriented, because 
that term carries so much intellectual baggage, but objects do 
play a big role in our language. The idea of treating data as 
objects, is one of the things that makes Spreadsheet 2000 so 
powerful. 

There are 4 major classes of objects in Spreadsheet 2000: 
Grids, Operators, Charts, and Notes. Each of these classes of 
object can come in many different shapes and sizes (you might 
even call them subclasses), and some samples are shown in 
Figure 4. The two most important of these classes are Grids 
and Operators. 


Visit MacTech Magazine’s Web site! 
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ADB I/O lets the Mac be part of the physical world. 
Thousands of Uses 





be electronically measured or controlled can use the ADB |/O. 
No Serial Ports Occupied 

ADB |/O uses the Apple Desktop Bus to communicate inputs and 
outputs to and from your Macintosh. (Maximum polling frequency 
is 90 Fz.) No external power supply is needed. 

Eight I/O Channels Provided 

Four relays for output. Four channels for Digital |n, 

Digital Dut or 8-bit Analog In. 
Extensive Software Support 

With ADB I/O and nearly any environment* 4 
it is easy to build customized /, 
applications for your control and 
data acquisition needs. 
For mare info, visit us at 
www.bzzzzzz.com. 






*ADB I/O supports three language environments, two script % 
with more on the way. Visit our home page to find,qui 
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Mac, go out and touch the world for only $ 


A ADB 1/O lets your customers' Macs control things, it lets them feel. 
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fa] Theatre Stages, Industrial Testing, Medical Research, Bonsai 
Watering, Robotics, Weather Stations—anything that can 
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Figure 4. Spreadsheet 2000 Objects. 


Grids 

Grids are basically collections of cells. Grids usually contain 
numbers, but you can also add labels which hold strings. Note 
that grids do not contain formulas, we use separate visual 
operators instead. There are 4 basic “subclasses” of Grid: T. able, 
Row, Column, and Cell. These types are differentiated only by 
their shape. A Table is a two dimensional collection of cells. A 
Row is a horizontal collection of cells, where a Column is 
organized vertically. The fact that each of these subclasses are 
treated differently allows for some interesting behavior, which I'll 
explain as we talk about Operators, 


Operators 

Operators are the objects which manipulate the data stored 
in Grids. Operators display an interesting kind of polymorphism 
which resembles function overloading in C++. Basically, 
Operators perform differently depending on what subclasses of 
Grid are connected to its inputs and outputs. Spreadsheet 2000's 
visual language is centered around the idea of overloaded 
operators. Let’s look at an example. 





Figure 5. Adding by Column. 
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Figure 5 shows a simple calculation with Spreadsheet 2000. 
It is using the + operator to add some numbers together. You will 
notice that it is adding the numbers by column. How does it 
know that is what you wanted? Because the output of the + 
Operator is connected to a Row object. Can we get it to add 
across instead of adding down? Sure we can. 





Figure 6. Adding two ways. 


In Figure 6 we just dropped in a Column object and 
connected the output of the + operator to the input of the 
Column object. Now that the + operator is attached to a Column 
it acts differently, adding across instead of down. Note that this 
single operator can service both grids. We can even take this one 
step further, as shown in Figure 7. 











Figure 7. Adding three ways. 


Now we drop in a single cell and connect the operator to it. 
since we are feeding into a single cell, it adds up all the numbers 
in the original grid and sums them together. 

Let’s take a look at another example of Spreadsheet 2000 
polymorphism. In this case we'll look at an operator with 2 


inputs instead of just one. 
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Figure 8. Multiply a Table times a Cell. 


Figure 8 shows the use of the A*B operator. In this case it is 
multiplying a Table times a Cell. As you can see from the figure, it 
is multiplying each value in the Table object times the value 
contained in the Cell object. Now what would happen if we 
multiplied a Table times a Row? Let’s grab the resize box on the 
Cell and stretch it into a Row. This effectively changes the class of 
that object. Then let’s put a number into the new cell that’s 
created inside the Row object. 





Figure 9. Multiplying a Table times a Row. 


Can you see what it is happening in Figure 9? It is 
multiplying the first column in the Table times the first cell in the 
Row, and the second column in the Table times the second cell in 
the Row. Since we changed the class of that Grid from a Cell to a 
Row (by stretching it) the A*B operator now changes its behavior. 
That’s pretty cool, but you’re asking why would I do that? Let’s 
build a simple “real world” example using these ideas. 
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Example: Building a Budget 

Let’s say that we want to build a simple budget, so that we can 
see our expenses for the year. We have a set of expenses which 
occur on a daily, weekly, or monthly basis and we want to see 
what comprises the bulk of our expenditures. We can use the two 
operators we explored in the last section to accomplish this. 


Yearly Expenses by 
category. | 
at 


Food Insurance Gas Movies Rent 





Figure 10. Our Budget. 


Figure 10 shows the document we constructed to solve this 
problem. Since daily expenses will occur 365 times each year, 
weekly 52 times, and monthly 12 times we can use the A*B 
operator to compute the total amount spent per year on each 
item. We can then add the columns in that Grid together to get a 
single Column using the + operator. Lastly we feed that Column 
into a Chart so we can see our results. 


Custom Operators 

That’s pretty cool for simple stuff, such as addition and 
multiplication, but can you do anything sophisticated with this? 
We certainly hope so. There is a set of 90 operators which are 
built into Spreadsheet 2000. These include operators for 
trigonometric functions, scientific functions, date and time 
functions, sorting, searching and even Boolean logic and loops. 
That gives you a lot of flexibility, but we can’t claim to have built 
in every conceivable operator. That’s why we let you build your 
own! Let’s look at an example of doing that. 

On our palette full of operators we have objects for 
computing Square and Square Root. These are commonly used 
functions, and we wanted people to have easy access to them. 
Now let’s say that you often need to take the cube root of a 
number in your calculations. We don’t have a Cube Root operator 
built into the program, but we do have a two-input operator 
called Root, which can take the n-th root of any number. You 
could use that (as shown in Figure 11). 
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Eddy Award Winner for Best New Developer Tool 
— MacUser Editors Choice Awards, 1993 


“A distinct improvement over ResEdit.” 
— MacTech /MacTutor 


“Resorcerer’s data template system is amazing!” 
— Bill Goodman, author of Compact Pro 


“Nuke ResEdit! Resorcerer is mission-critical for us.” 
— Dave Winer, Userland Frontier 


“The color pixel editors are wonderful! A work of art!” 
— Dave Winzler, author of Microseeds Redux 


“Every Macintosh developer should own a copy of Resorcerer.” 
— Leonard Rosenthol, Aladdin Systems 


“Resorcerer will pay for itself many times over in saved time and effort.” 
— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
— Bill Steinberg, author of Pyro! and PBTools 


“Resorcerer proved indispensible in its own creation!” 
— Doug McKenna, author of Resorcerer 


“,..a wealth of time-saving tools.” 
MacUser Revieu, Dec. 1992 


RESORCERER 


als Resource Editor for the Macintosh Wizard 





Version 1.2.4 


ORDERING INFO ¢ New ‘cicn’, ‘ppat’, ‘crsr’, ‘acur’, ‘pltt’, ‘clut’ editors 
¢ Powerful icon family editing (all 9 icon types) 

¢ Color pixel anti-aliasing, dithering, and lots more 
¢ Complete ‘PICT’ disassembly and reassembly 

¢ Resource sorting; ROM resource browsing 

e 120 template field parsing types now supported 

e New insertion & deletion template field types 

e Text-only ‘PICT’ resources 

¢ Lots of improvements throughout 


Needs: >Mac Plus, 2 Sys 4.2, 1MB 
Likes: >Mac Plus, = Sys 7.0, 2MB 
32-bit clean, AU/X compatible 


New 1.2 Features: 


Price: $256 (decimal) 
(Educational, quantity, or 


other discounts available) 
Includes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 


Payment: Check, PO's, or Visa/MC 


Extras (call us): 
COD, FedEx, UPS Blue/Red, 
International Shipping 


Downloadable Demos/Updaters: 


AppleLink: Software Sampler 
AOL: Software Libs/Development 
CompuServe: MACDEV/Tools 

or call us. 





P.O. 


¢ Easier, faster, more Mac-like, and more productive than ResEdit 

¢ Safer memory-based, not disk-file-based, design and operation 

e All file information and common commands in one easy-to-use window 
¢ Compares resource files, and even edits your data forks as well 

e Visible, accumulating, editable scrap 

¢ Searches and opens/marks/selects resources by text content 

¢ Makes global resource ID or type changes easily and safely 

¢ Builds resource files from simple Rez-like scripts 

¢ Most editors DeRez directly to the clipboard 

¢ All graphic editors support screen-copying or partial screen-copying 
¢ Hot-linking Value Converter for editing 32 bits in a dozen formats 

¢ Its own 32-bit List Mgr can open and edit very large data structures 
¢ Templates can pre- and post-process any arbitrary data structure 

¢ Includes nearly 200 templates for common system resources 

¢ TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 
¢ Full integrated support for editing color dialogs and menus 

¢ Try out balloons, ‘ictb’s, lists and popups, even create C source code 
¢ Integrated single-window Hex/Code Editor, with patching, searching 
¢ Editors for cursors, versions, pictures, bundles, and lots more 

¢ Well-designed, helpful developer tools being added all the time 

¢ Relied on by thousands of Macintosh developers around the world 


MATHEMASTHETICS, INC. 
Box 298 ¢ Boulder © CO ® 80306-0298 « USA 
Phone: (303) 440-0707 © Fax: (303) 440-0504 


AppleLink/AmericaOnline: RESORCERER ©° Internet: resorcerer@aol.com 








Figure 11. Finding the cube root of 27. 


Now that works fine, except it seems like a like of work for 
something you’ll want to do often. That is what Custom 
Operators are for. Let’s look at how we could build a new Cube 
Root operator. First you need to select the items which are central 
to your calculation. You can do that by shift-clicking or drag- 
selecting. Once you have these items selected you'll want to 
choose the Crunch menu item. 
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Figure 12. Building a Cube Root operator 


After you choose Crunch, you'll be prompted to give your 
new operator a name. The result is a new Cube Root operator 
which can be used again in this document or in other documents. 
You can even save this operator into one of your own custom 
palettes. You can then give these palette files to your friends, or 
even upload them to the Internet. We hope to build a cottage 
industry around people building and sharing custom operators 
and other Spreadsheet 2000 documents. We have even built a site 
on the web where people can upload and download Spreadsheet 
2000 documents and operators. Visit Emergent Behavior’s 
Spreadsheet 2000 web page <http://www.emer.com/s2k> for more 
info. 
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WRITING SPREADSHEET 2000 


We always get a good response from people at user groups 
and trade shows when we demo Spreadsheet 2000. Developers, 
in particular, seem to really like it. After the demo they often ask 
me what I used to write it, and I tell them Prograph CPX. After 
the poor programmer pulls his jaw off the floor, and puts his eye 
balls back in their sockets, he asks me if I’m kidding. If you 
haven't yet heard of Prograph then you should check out some 
of the great articles from past MacTechs which are referenced at 
the end of the article or stop by <http://www.pictorius.com>. Figure 
13 shows an example of some Prograph source code. In this 
article ’'m not going to dwell on the technical details of Prograph 
(there are many fine MacTech articles which do that). I want to 
give you my general impressions from using it to build a large 
application. 


<< indow >> 


2 #Find Window Item ~ 





Figure 13. The Prograph source for closing my about box. 


It seems that many people have heard of Prograph, and 
some have even tried it, but few people believe that Prograph 
can be used to write a “real” application. I’m here to tell you that 
you can. Prograph often get’s lumped into the same category 
with products like MicroBrew (formerly AppWare), HyperCard or 
MacroMind Director. The fact is that Prograph is a much more 
powerful general purpose programming tool. With tools like 
MicroBrew, HyperCard or Director you can very quickly build 
certain types of programs, but you generally run into a wall 
where you must write some kind of C code to get a particular 
behavior you want. HyperCard XCMDs are an example of this. 
Although Prograph can import existing C code, Prograph doesn’t 
have these limitations, and Spreadsheet 2000 illustrates how 
powerful Prograph can be. Let’s look at some facts about 
Spreadsheet 2000. 


Spreadsheet 2000 Facts 
Spreadsheet 2000 is written in 100% pure Prograph, and 
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supports the basics you expect from a real application. It is a 
stand-alone, double-clickable application which supports 
multiple w ndows and documents, floating toolbars and 
cut/copy/paste. It even supports some things you might not 
expect, such as Drag Manager. One thing to keep in mind is 
the fact that I didn’t write any external C code. Prograph gives 
you full access to the Mac Toolbox, so there isn’t any kind of 
application you can’t write with Prograph. One key detail that 
shouldn’t be left out is that Spreadsheet 2000 is PowerMac 
native. Prograph has compilers which generate real 68k and 
PPC assembly language. (An Intel x86 compiler is also in 
Beta.) You don’t need any run-time baggage, such as byte 
code interpreters or run-time engines. You are a first class 
citizen on the desktop. 

Now that we've established that it is possible to write serious 
applications with Prograph, we come to the question of whether it 
is practical. Once again, I believe the answer is yes. Spreadsheet 
2000 is imp emented using about 450 Prograph classes which 
contain about 4000 total methods. About 150 of those classes are 
the ABC Application Framework which comes with Prograph CPX. 
About 50 of those classes are add on libraries from third parties, and 
the rest are Spreadsheet 2000 specific. 450 classes is a fair sized 
OOP project by most standards, and Prograph handles it without 
showing signs of stress. I should also mention that I use VOODOO 
from Unisoft for source code management. It does a great job of 
keeping track of the 100+ source code files which are used to build 
Spreadsheet 2000. 

Prograph’s greatest benefit is productivity. Version 1.0 of 
our application was written using about 2 programmer years of 
effort. Moving from version 1.0 to 2.0 took us about another 7 
months. That may see like a lot, but that is nothing when 
compared with other productivity applications, especially 
when you consider that time includes Prograph’s learning 
curve. I’m a pretty fair C++ programmer (I’ve taught Apple 
Developer University’s course on Advanced C++ many times), 
but I just cen’t write code as fast in C++ as I can in Prograph. 
Add in the ‘act that Prograph’s garbage collector takes care of 
most memcry management tasks, and you can really start to 
see Prograph’s benefits. 

The otner thing which needs to be mentioned here is 
debugging. Let’s face it, what percentage of your time do you 
spend writing new code vs. debugging existing code? Prograph 
has the world’s best debugging environment. I make this 
sweeping statement without apprehension. Prograph’s 
environment is more conducive to debugging than any other. 
When you encounter an error in Prograph the machine doesn’t 
bomb. Prograph halts the execution of your program and puts up 
a dialog explaining the difficulty. (See Figure 14 for an 
example.) You can then rollback execution of the program, make 
modificaticns to your source code and continue to run the 
program. I’m sure you’ve done the old: Compile, Link, Test, 
Modify, Compile, Link, Test, Modify cycle. With Prograph you 
can shorten that to: Test, Modify, Test, Modify. 
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superior client/server application? 
A: A SUPERIOR SERVER 


START with the 
most advanced client- 
side SDK on the 
market: c-tree® Plus 
at $895. 
¢ Complete “C” Source code 
¢ ROYALTY FREE 
(Client Side) 
* Multiple supported 
protocols 
e Fast, portable, reliable 
¢ Powerful features like 
transaction processing 
e Win95, NT, and 
Windows 3.1 ready 


ADD a strong, 


multi-platform, 
industrial-strength 
Server that supports. 


e File mirroring 


¢ Heterogeneous networking “= 
MAC 


¢ Automatic disaster recovery 

e Multi-threaded design 

¢ Best price/performance 
available: from $445- $3745 


RESULT? 


A solid, economical, 
easily deployable 
product that fits 
your needs. 

e Portable 

¢ Scalable 

e Exceptional Performance 
¢ Flexible 

e Easy Server distribution 
¢ Convenient OEM terms 


FAIRCON?® 
Server 


Heterogeneous 
TCP/IP Network 


You can’t find a better client SDK with these features! 
Over sixteen years of proven reliability and performance. 
No one else supports over 30 platforms in this price range! 


c-tree Plus® 

¢ Complete C Source 

¢ Single/Multi User 

¢ Client/Server (optional) 

e Full ISAM functionality 

¢ No Royalties 

e Transaction Processing 

e Fixed/Variable Length Records 

¢ High Speed Data/Index 
Caching 

¢ Batch Operations 

e File Mirroring 

¢ Multiple Contexts 

¢ Unsurpassed Portability 


FairCom® Server 
¢ Client/Server Model 
e Transaction Processing 
e Requires <2MB RAM 
e Online Backup 
e Disaster Recovery 
¢ Rollback - Forward 
e Anti-Deadlock 
Resolution 
¢ Client-side "C" Source 
e Multi-threading 
e Heterogeneous networking 
e File Mirroring 
¢ OEM/Source Available 
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Prograph is attempting to call a universal method 
called ‘Open Database File’. That method does not 
exist. Do you want to create it ? 


Figure 14. Prograph offering assistance to fix a bug. 


The Flip Side of Prograph 

I've now made Prograph sound like the second coming, 
but I should fill you in on its limitations. Although Frograph 
can write any type of application there are types of programs 
which it cannot produce. Prograph cannot create stand-alone 
code resources which means you cannot build Photoshop 
filters or Netscape plug-ins. You also cannot currently build 
OpenDoc parts. 

Performance is another issue of concern for many. 
Compiled Prograph code is not as fast as compiled C++ code. A 
program written in C++ will also generally be smaller, and 
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require less RAM than an equivalent Prograph app. If speed and 
application size are your main concerns then you will want to 
experiment with Prograph some before committing major 
resources to Prograph. 

I should add a couple more comments before closing this 
subject. First, the Toolbox is the Toolbox, no matter what 
language you use to call it. For example, a call to CopyBits 
doesn’t take any longer when called from Prograph than from 
C++. The other comment is more qualitative, bad C++ code is 
slower than good Prograph code. Although Prograph is often 
slower than C++ for equivalent operations, your choice of 
algorithm may still be the most important issue. A bubble sort 
written in C++ will not be faster than a quick sort written in 
Prograph. Your skill as a programmer, and your knowledge of 
your problem domain is ultimately much more important than 
your choice of language. 


The Future of Prograph 

Prograph is being actively supported and improved by 
Pictorius. Right now early versions of Prograph CPX for Windows 
are available. I've worked with some of these early releases and I 
was pleasantly surprised. Prograph is going to be a serious choice 
for developing your cross-platform applications 


CONCLUSION 

I hope you’ve enjoyed this brief exploration of visual 
programming. Visual programming languages are often quickly 
dismissed as toys, but I hope that the success of tools such as 
Spreadsheet 2000 and Prograph will change that. Although text 
based languages (and spreadsheets) will not disappear anytime 
soon, I think that visual alternatives will start to become a serious 
option more often. The best way to figure out if visual 
programming is right for you is to take a test drive. If you're 
interested in Prograph, there is a demo CD with a crippled 
version of the environment available from Pictorius. 

In this article I've only scratched the surface of Spreadsheet 
2000. There are a number of features, such as our reporting 
options which let you build simple front ends to your 
calculations, which I haven’t addressed at all. If you're interested 
in Spreadsheet 2000 then you can get a demo off the web at 
<http:/www.emer.com/s2k>. That is the best way to get a feel for the 
program. Have fun. 


Places to see on the web 

<http:/www.emer.com/s2k> has all sorts of info on Spreadsheet 
2000 and includes a FAQ and a library of documents for 
downloading. | 

<http://www.emer.com/MadeWithPrograph> is a list of over 40 
Macintosh applications which have been written with Prograph 
CPX. 

<http://cocoa.apple.com> Cocoa version DR/1 is a visual 
programming language for kids. It also happens to be written in 
Prograph CPX. 

<http:/www.pictorius.com> general info on Prograph CPX. 





MACTECHMAGAZINE © APRIL 1997 





Purify on Unix 
1s Checker on Windows 
is of Ol OF comes... 


Find Bugs Fast 

Spotlight is the first Automatic Memory Debugger for the 
Macintosh. Instantly detect invalid memory accesses, bad 
toolbox parameters, leaks, stack overwrites, memory reloca- 
tion problems, and much more. 

Spotlight uses your XSYM file to automatically patch your 
application — no need to change your source code. No need 
to recompile. No learning curve whatsoever. 

The interface gives you instant feedback when an error is 
detected. You can ignore the error, ignore all future occurrences 


of the error, or log the error to a text file for later analysis. 


Fine Grained Memory Protection 

Spotlight identifies reads and writes outside of the applica- 
tion and system heap. But it does not stop there. Spotlight’s 
Object Code Replacement instrumentation inspects each read 
and write instruction in your code, detecting faulty memory 
reads and writes that occur between blocks, in released blocks, 
across multiple blocks, and in ROM. 

This technology works on any heap object you can allo- 
cate: Mac heap objects, C ‘malloc’ heap objects, even C++ 
objects created with new. 

Spotlight stops your application whenever a faulty memory 
access is about to occur and displays the exact source code 
line where it will happen. The calling stack is shown along 
with a display of all variables. A memory viewer shows the 


erroneous memory address and contents. 


Toolbox Validation 

Spotlight checks parameters to over 400 toolbox API calls, 
automatically validating handles, memory blocks, return val- 
ues, and so on. Specific checks catch subtle errors such as draw- 


ing into an unlocked GWorld, passing an invalid window 


On Macintosh 





pointer, passing an address within an unlocked handle to a 
routine that may move memory, and too many more to list. 


Leak Detection 

No more struggling with MacsBug. On program exit Spot- 
light provides a clear listing of all leaked memory showing a 
full stack trace from where the memory was allocated. Instantly 
discover all leaked Mac OS objects, malloc’d objects, 
C++ objects, and resources. 


Limitations 

Spotlight requires an XSYM file to function. MPW and 
CodeWarrior users can generate these directly. Symantec us- 
ers must use ToolServer to link with an XSYM capable linker. 
Spotlight requires a PowerPC processor. 

Spotlight works on the object code. No source code is re- 
quired: just the thing for testing purchased third party libraries. 


Availability and Pricing 

Pricing for Spotlight DR1 is $199 US (plus $5 shipping and 
handling within the continental US, $15 for international 
orders). This includes a free upgrade to the GM version and 
access to ftp interim upgrades leading up to GM. QC users can 
cross-grade to Spotlight for only $149. 


All Onyx products carry a 30 day no questions asked money 
back guarantee. 


Onyx Technology, Inc. 
7811 27th Avenue West 
Bradenton, Florida 34209 





www.onyx-tech.com 


941 795-5901 (fax) 


sales@onyx-tech.com 


941 795-7801 





Spotlight and QC are trademarks of Onyx Technology, Inc. All other trademarks are property of their respective owners. 





We've added a new piece to the software 
a ==] distribution puzzle — electronic transaction 
a processing. Increase sales and slash costs 
UPTO 128 ~~ ™ — by safely distributing software on the net, 
mMieaetvieeee ~—séoiline services, CD-ROMs and (!!) floppy disks. 
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Skeptical? StuffIt InstallerMaker has long been the 
‘Complete Installation Solution, providing everything 
you need to create installers and updaters. To see 
for yourself, download a ree, fully functional copy of 
Stuffit InstallerMaker 4.0 from www.aladdinsys.com, 
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By Edward Ringel 








Newton? Get Serious! 


eee 


Life is changing in the hand- 
beld computer world... 





Several months ago I got interested in 
mobile computing, and I discovered the 
Newton MessagePad 2000 from Apple. I 
believe this new palmtop computer is a very 
appealing product for a large segment of the 
portable computing public. The introduction 
of this device is a significant, new, and 
exciting marriage of hardware, software and 
market opportunity that demands careful 
scrutiny by MacOS developers. 

I was fortunate enough to be allowed 
to use a MessagePad 2000 for a month. 
Apple Computer and its staff were most 
gracious in their support of this project and I 
wish to thank all involved publicly. I was 
also given the opportunity to use and 
examine the Apple development 
environment for Newton, the Newton 
Toolkit. It is beyond this article to give a 
comprehensive evaluation of the market, the 
hardware, and_ the development 
environment. However, I would like to give 
you my perspective on this product, and 
justify my obvious personal enthusiasm. 


SOME BACKGROUND 

In the last several years, as portable 
computers have become commonplace, 
mobile computing has taken on a life of its 
own; the distinctive laptop traveling bag is 
an icon at all major airports. Despite their 
utility, many companies don’t want to buy 
their employees laptops because the 


computers are expensive and many of the users do not need that 
kind of horsepower. Financial issues notwithstanding, there are a 
large number of individuals who need a mobile computer, but to 
run one or two or three simple, relatively small programs, and do 
not need all the bells and whistles of a full operating system. 
Furthermore, most people in a mobile computing situation are 
working on just a piece of a project at any given time. The user 
needs only part of the data because the necessary processing is 
occurring in a distributed manner. 

Mobile computer users, in addition to specific applications 
that are needed for execution of job specific tasks (such as 
specialized electronic forms, order/inventory entry, etc.) have two 
needs that apply across the market. First, there is need for 
productivity software. This is the contact management, address 
file, and datebook paraphernalia that sometimes seems to be the 
meat and potatoes of modern corporate computing. In addition to 
this category I would add lightweight versions of basic word 
processing and spreadsheet programs that integrate with desktop 
applications, so that a piece of the current project can be brought 
on the road. Second, there is a need for connectivity software. The 
mobile user will not have all necessary information with him or her 
at all times, and it is imperative that the user be able to retrieve 
data and send messages easily and in multiple formats. 
Connectivity is perhaps the most important paradigm shift in all of 
computing in the last five or so years, and the need for this 
capability is particularly pronounced for portable users. 

Mobile users are more likely than those at a desktop 
computer to engage not only in sustained data entry, like typing 
this article, but in bursts of data entry such as filling out an 
electronic form, jotting down an idea or an outline, or drawing a 
quick diagram. Unlike desktop users, mobile users will 
sometimes be in a situation where physical space may be at a 
premium, or position may be awkward. These two factors make 
size of the device and stylus entry a strong positive. 

As an alternative to traditional laptops, Apple introduced the 
Newton several years ago. I’ve had the Opportunity to talk to 
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several devoted (and not so devoted) users. People have been 
intrigued with the handwriting recognition, the relative power 
compared to organizers, the clever and friendly operating system, 
and the size relative to laptops. Sadly, handwriting recognition has 
been slow and spotty, particularly pre-Newton OS 2.0, and this has 
rendered stylus based input a misery for any sizable amount of 
information. Memory has been expensive, and general processing 
has been slow. Screen pixel depth has not permitted any kind of 
serious graphics, and until the MP 130, backlighting was not 
available. Both of my friends who still use Newtons use them 
almost exclusively for data retrieval from electronic books. 

Nonetheless, the promise of the idea of a small, powerful, 
hand-held computational device continues to beckon, waiting for 
a hardware/software combination that finally allows the genre to 
come into its own. Hitachi, Philips, NEC, and Digital have created 
low voltage, low current very powerful CPU’s that are being used 
in palmtops, and many hardware and software developers see 
the enormous potential market. Microsoft, in particular, has 
decided that this aspect of mobile computing is sufficiently 
interesting to warrant its attention, and the result is a series of 
palmtops using the Windows CE OS. (The OS isn't bad. I don’t 
like the hardware I’ve seen.) 

It is in this setting that Apple has introduced the MessagePad 
2000. Just as a PowerMac 9500 and a Mac Plus are both Macintosh 
computers, a MessagePad 100 and a MessagePad 2000 are 
Newtons. However, you can do some things with a 9500 that you 
can’t do with a Mac Plus... 


HARDWARE AND SOFTWARE 
Hardware 

The Newton MessagePad 2000 will be available first quarter 
1997, probably late March. (This article was written in January 
1997.) It is about the size of a VHS cassette, measuring about a 
quarter of an inch wider and three quarters of an inch longer. The 
screen is just slightly smaller than a 3” by 5” index card. With no 
extra stuff (fancy PC cards, etc.) it weighs slightly over a pound. 
The screen has a pleasant blue electroluminescent backlighting. It 
has two PC card slots, a speaker, a microphone, and a connections 
port. My unit had a rechargeable NiMH battery pack and an AC 
adapter. I liked the battery pack in that it recharged in an hour, and 
lasts 24 hours. 4 AA alkaline batteries, according to Apple, will 
power the device for 36 hours. Iam not a physically big person; the 
device was comfortable to hold and carry. The stylus that comes 
with it pops into a holder in the computer, and there is a cover over 
the resistive screen. The screen seemed quite delicate, and I suspect 
that the use of Write Right screen protectors would be mandatory 
for long term, heavy use. 

The heart of the computer is a Digital StrongArm SA-110 
RISC processor running at 161.9 MHz. The Message Pad 130, for 
comparison runs at 20 MHz. The result (and maybe this is the 
punchline of the article) is that the MP2000 does most operations 
at least two or three times faster than its best predecessor, and 
more in some operations. Functionally there was a snappiness to 
operations that was pleasant and responsive. Handwriting 
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recognition was quite fast, although I would still want to use a 
keyboard for sustained input. The machine comes with 8 Mb of 
ROM. 5 Mb of RAM, 1 Mb DRAM and 4 Mb Flash RAM, are 
available to the OS and your applications. Two Type II PC slots 
are available for modems, ethernet connectors and memory cards. 
Multiple modem and fax protocols are supported. 

The screen has 100 dpi resolution and is 480 by 320 pixels, 
exactly one half of a VGA screen. The device can support 16 gray 
shades, and as I said above, is pleasantly backlit. I found that I 
preferred the backlighting in most ambient light settings, but this 
had negative impact on battery life. The stylus that comes with the 
MP2000 is light and uncomfortable; I suspect the aftermarket in 
upscale styli will be considerable if these little fellers catch on. 

In addition to the PC slots, there are several I/O ports. Both a 
built in speaker and microphone are present. There is an infrared 
port for data transmission supporting IrDA and ASK modes. (IrDA is 
a faster, newer protocol.) The IrDA connection to my LaserJet SMP 
was seamless, There is a Newton Interconnect external port that 
supports RS-422 serial connections, LocalTalk, serial modem 
connections, audio I/O, and a keyboard. Apple currently makes 
only a DIN-9 connector that has only one plug. However, were the 
connector hardware available, multiple devices (such as keyboard 
and printer) could be connected simultaneously. (Do I smell a third 
party opportunity here?) I used this port to connect to my desktop 
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external modem, to my Performa 6200, and to my Personal 
LaserWriter LS, and again, there were no problems with any 
connection. In all, the hardware platform is high quality. 


Software 

The Newton ships with both operating system and end-user 
application software. The software services provided by the OS (2.1 
in this device) are unique and ubiquitous. Just as the Mac provides 
developers with multiple tools and services, so does the Newton. 

Handwriting recognition is strongly associated with the 
Newton, and this is actually an operating system service; any 
application can ask for a complete set of handwriting recognition 
services, including delayed recognition (ink text), recognition 
correction systems, access to word lists, restricted input (number 
only, alpha only, etc.). The stylus input system includes tap 
keyboards such as typewriter, numeric, phone dialer, and custom 
constructs. 

I used handwriting/stylus input extensively in my testing, and 
after some initial problems I was able to achieve 90 to 95% correct 
input. After using the MP2000 for about 2 hours I had found the 
areas of greatest difficulty in recognition of my handwriting, 
tweaked some parameters, modified how I wrote a couple of letters, 
and was home free. Clearly, the device learned to recognize my 
handwriting. Word recognition is as important as letter recognition, 
and I was able to add to the 93,000 word dictionary; my loaner 
Newton had a nice medical word list by the time I returned it. In 
comparison, I used an MP 100.upgraded to a 110 OS and configured 
for a guest user; my correct input rate was about 50% and 
recognition was very slow. In sum, I would not be averse to using 
stylus input for routine “burst” entry on the MP2000. 

Communications services are also an integral part of the OS, 
supporting Internet protocols, serial communications, and faxes. 
(Tunneled AppleTalk and Ethernet are not yet available.) Again, 
these services are available to any application. I was able to set 
up the computer for my Internet account in about 10 minutes and 
it worked my first try. 

Connectivity services are somewhat different from 
communications; I classify this as docking to a printer, backing 
up data, using the infrared port, or communicating with a 
running desktop application. High level interfaces are available 
to any client application. 

Two less obvious but very important services are also 
generally available. The first is intelligent assistance. In some 
respects, this is somewhat like AppleScripting, but with a flair. 
When assistant services are requested, a slip (Newtonese for 
dialog box) comes up that allows you to write in an action 
request, such as “take a note.” In this case, you would be 
presented with the note application and a fresh sheet of paper. It 
is also possible to create a scripted action such as “phone Bob.” 
In this case, the request “phone Bob” triggers the script to phone 
Bob. It is possible to create scheduled and repetitive actions 
using this mechanism, which is obviously very useful. 

The second important service is data storage. The Newton 
operating system supports a generic object oriented filing and 
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indexing system, called soups, that tremendously simplifies data 
storage and retrieval. Data from an application is stored in a 
soup, which can be indexed, traversed, and accessed randomly. 
From an application development standpoint, I see this as an 
outstanding system service. 

Of course, there are a variety of programming interfaces to 
GUI services and general application services, which will be 
described in the development section below. 

The Newton MP 2000 also ships with several full fledged 
applications. There are a number of “PDA” level applications: 
Name and Address Book, Calls, Notes, and Dates. The Names 
application is an address book application, and the Dates 
application is an organizer/datebook application. Both are high 
end flavors of these tools. The Notes application is somewhat 
misleading, in that the notes can be quite sophisticated. Plain 
text, outline mode, and audio notes can all be maintained. The 
Notes application accepts stationery (more on that below) which 
permits specialized format notes as well. 

The MP2000 will ship with a portion of Newton Works, 
which in some configurations will provide both basic 
spreadsheet and word processor capabilities. The spreadsheet is 
straightforward and similar to every Mac spreadsheet I’ve ever 
used, although it does not have a macro capability, and the range 
of functions is limited. The spreadsheet can import/export 
from/to Excel. The word processor has simple formatting and 
fonts, rulers, cut, copy, and paste, etc. The general feel is that of 
relatively early MacWrite applications. The word processing 
module does not permit stylus entry, which I find surprising. 
Even though sustained data entry would not be done by stylus, 
editing lends itself nicely to pen based input. I think this is one of 
the few design decisions with which I strongly disagree. 

Communications applications include an e-mail client and 
NetHopper, a web browser. The e-mail client works directly with 
an application called In-Out Box, a manager for all 
communications and connectivity functions. Dial up is automatic 
when either the email client or the browser are activated. The Net 
browser was text and/or image based. Unfortunately, the unit 
froze when I was in image mode. Some of the pages I hit looked 
very odd; I think there is a development opportunity here that I 
will get to shortly. The e-mail client treats messages as notes, and 
worked well. Attachments are handled properly, although one 
would probably apply a size filter rule. The rules editor for the 
email client was rudimentary and must be improved substantially. 


DEVELOPING NEWTON APPLICATIONS 

Custom solution applications and shrink wrapped programs 
with broad appeal can be developed for deployment on this 
platform. The Newton Toolkit is the primary means of application 
development on this platform. This IDE is a combination text editor, 
graphical GUI builder, and NewtonScript compiler engineered by 
Apple Computer. There is a Newton Basic software package that I 
did not review. I did, however, visit their web site and was impressed 
with what appeared to be a committed company and a vigorous user 
presence. Given the structure of the Newton operating system and 
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the programming interface, however, my bias (admittedly sight 
unseen) would be to use the Newton Toolkit for commercial 
development. (Writing as an editor for a moment, we hope to review 
NS Basic in the relatively near future.) 

The Newton API, the Toolkit, and the programming 
language are all closely linked. It makes the most sense to start 
with the language, NewtonScript. 


NewtonScript 

NewtonScript is a neat language. It is an object oriented, 
dynamic language that uses prototype inheritance (similarity 
based) and parent inheritance (container based). This means that 
your object can inherit messages and variables from both the 
prototype and the parent view. It has automatic garbage 
collection. It is an interpreted language (although small chunks 
of native code can be generated by the Toolkit for performance 
critical portions of the code) and the Newton supplies a virtual 
machine byte code interpreter. These characteristics make for an 
extraordinarily parsimonious language with respect to system 
resources, particularly memory. 

The syntax is a comfortable mix of (Object) Pascal, C++), 
and elements native to neither language. Instead of records and 
fields, one refers to frames and slots. Slots may be added and 
deleted dynamically. One of the characteristics of prototype 
inheritance that is particularly appropriate for a small memory 
machine is that an object descended from another object makes 
its own copy of a slot only if the value of that slot is different 
from that of the inherited prototype; otherwise it simpy contains 
a reference to the inherited prototypes. 

A good variety of built-in functions are available, as are the 
usual control constructions, although a traditional case/switch 
structures is conspicuous by its absence. (As an aside, it is 
possible to construct a neat dynamic switch with NewtonScript.) 
There is obviously a learning curve to NewtonScript, but I do not 
think it is onerous. Full mastery of the language would probably 
take more work, though, than it would appear on the surface 
because one’s programming style would have to be altered to 
take maximum advantage of the subtleties of this dynamic 
language. There is a good language reference that comes with 
the ToolKit, and Programming for the Newton also has a good 
introduction to NewtonScript. 


The Newton API 

NewtonScript is the means of access to the Newton API. I have 
alluded to some of the features already: handwriting recognition, 
I/O in all its permutations, and soups. Also available is a wide 
variety of GUI design elements that are similar to those on any GUI 
based platform: views (windows), slips (dialog boxes), button, 
menus, list pickers, and the like. Using prototype inheritance, 
templates and prototypes for these objects all reside in ROM; all 
your program does is derive its elements from preexisting 
prototypes. A “plain vanilla” button, therefore, would override (and 
therefore allocate) only a few slots and methods and get the rest of 
its behavior from its prototype. This saves a considerable amount of 
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memory when you start adding up objects in a program and is 
achieved easily with a dynamic language. 

Given the size of the unit, the device offers a strong array of 
programming elements. Although the computer does not support 
color, fairly complex graphics can be displayed in 16 grayshade 
depth. A variety of buttons, views, lists and menus can be 
displayed. There are a number of Newton specific elements, such 
as a typewriter keyboard that is displayed on the screen and 
responds to taps on its “keyboard.” The unique feature here is 
that this is a system service, and your program simply needs to 
ask for the keyboard, accept the input of the typing, and then 
dispose of the keyboard when done. No other management is 
required. Similarly, an analog clock and a map picker are 
available. I was impressed by how easy it would be to put 
together a visually pleasing, functional program without having 
to write code for my own design elements. 


The Newton Toolkit 

API meets NewtonScript in the Newton Toolkit. This 
application is available both on the MacOS and Windows, and is 
the development environment for the Newton. The Toolkit 
permits the graphical construction of the interface (creating 
layouts), development of templates (your own base classes), 
writing and editing the program in NewtonScript, and debugging 
on the target device (a Newton OS based machine) by means of a 
serial connector cable or an AppleTalk LAN. 


‘om 
protoLabelPicker : s \yLabelCommandsPrefix 
protoStaticText ckerSetup 
protoStaticText 
protoStaticTex 


x 
Methods y ][_Attributes 
storePicker labelActionScript 
func< index > 
begin 
local newStore := nil; 
if index > 0 then begin 
index := index - Length<myLabelCommandsPref ix); 
/?# index now is in the range O..Lengt(GetStores¢ >) -1 
newStore := GetStores¢ [index]; 


end; 
GetRoot¢ >. (kAppSymbo! >: ChangeStore(newStore ); 





Figure 1. This screen shows the editor window for the 
Newton Toolkit. The pane in the upper right hand corner 
shows scripts and members of the object being edited. The 
lower right hand pane shows a typical NewtonScript script. 

The upper left hand scrolling pane is the list of editable 

objects in the project. Behind the editor window and partially 
obscured is the view building window. It is possible to 
preview, but not emulate function of, an application. 
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Figure 2. This screen shows the tool palette for building views. 
After selecting an element, it is dragged to the view building 
window, where it is sized. The view is named and given unique 
functionality in the editor window by setting flags, writing scripts, 
etc. NTK takes care of many of the details of this process for you. 


While I would need a more thorough understanding of the 
API and NewtonScript to get any serious work done, I certainly 
was able to learn quickly to dabble. Program construction takes 
place in several steps. One first picks a screen format and then 
places various views from a palette on the Newton screen. These 
views are the application view, various slips, and other window, 
control, and text elements that comprise the program. Each of 
these objects can be manipulated to fine tune behaviors, and then 
one may attach a series of scripts to the object. A push button, for 
example may have only a “do the press” script. A text field, on the 
other hand, may have a set default script, tab-in script, tab-out 
script, and an entry validation script. 

All of these are edited in the NTK text editor. Since no single 
script will be enormously long, the editor is comparatively 
lightweight compared to the Symantec, Metrowerks, and BBEdit 
programs, but it gets the job done nicely. It is possible to create 
one’s Own prototypes and templates as well as use those 
supplied by the API. The testing of the program is on the 
Newton; there is no Newton emulator in the Toolkit. The major 
debugging tool is the Inspector, which allows comprehensive 
program control and monitoring during development. It is 
possible to place debugging functions in your code, and for the 
bravehearted, one can modify parts of the target application on 
the fly to test possible fixes. 

Version 2.0 of the Newton OS includes NewtApp, an 
application shell which can speed development. 
Documentation carefully describes applications for which the 
shell is and is not appropriate. There are a number of 
specialized protos for NewtApp, and like the other protos, the 
NewtApp shell resides in ROM. 

The development files are maintained separately on your 
desktop’s hard drive; there is no single large project file. At 
compilation, a Newton package is created. The package consists 
of the various elements necessary to run your application; the 
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sackage can be run by either downloading from a host computer 
or coming pre-installed on a PC card. 

NTK includes the Newton BookMaker. This is a streamlined 
means of developing large blocks of data that can be retrieved 
for review by the user; as the name states, BookMaker helps you 
create electronic books. BookMaker’s appeal for a developer lies 
in the ability to use Newton OS services in presenting the 
information to the user, and developing queries about 
information in the book. 

Finally, NTK also supports the creation of stationery. T hese 
are essentially plug in modules that extend the functionality of a 
base application; the audio recording note, for example, is 
supported as a stationery item for the Notes application. This can 
be a useful route to development if all you want to do is create a 
specialized data entry form that is then filed, for example, as a 
note. It also allows others to extend your base application, which 
can be beneficial to your marketing as well. 

Apple Computer supports the Newton with a developer’s 
program and a developer’s CD. I had access to the November, 1996 
mailing, and was pleased with the mix of technical information, 
marketing data, and (most of all, for the neophyte) sample code. 

It is difficult for me to envision insurmountable obstacles to 
development with this system. For a C++, ANSI C, or Pascal 
programmer, the worst I could see would be what I call the 
“French-Spanish” problem; the languages are sufficiently similar 
to create an illusion of mastery of both, but different enough to 
create syntax and grammar errors regularly as one flips back and 
forth. It may be difficult for some to learn to write 
parsimoniously. Finally, it may be difficult for many to 
understand how to exploit the Newton market effectively. 


Wuy DEVELOP FOR THE NEWTON? 

The hardware is terrific; the OS has been souped up; the 
development environment is a programmer's dream. Is the 
Newton an answer in search of a question? 

To a degree, yes. Writing miniature desktop programs is not 
what Newton development is all about. This is a unique 
technology that has just experienced a major hardware/software 
upgrade. The person (or company) who spends a thousand dollars 
or more for a Newton is fulfilling a different need from a desktop 
or laptop user. Successful development will hinge on recognizing 
the paradigm of the hand-held user and understanding his or her 
needs. I don’t pretend to understand fully the marketplace. 
However, I used the Newton as an end-user for a week and let a 
couple of savvy friends spend some time with it. To get a flavor of 
the broader market, I also bought an issue of Pen Computing, 
which is devoted to palmtop and stylus based computers and 
applications. 

I was struck by opportunities in both horizontal and vertical 
markets. There were several recurring themes in both areas. The 
first, for want of a better term, is hyperportability. One example 
of this was my professor friend who latched onto the 
opportunity to take the MP2000 into the stacks; she could never 
take her laptop into this crowded area, set up, and comfortably 
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take notes. This on-site data collection extends to business, 
industry, and scientific settings as well. The second theme was 
that of using the instrument in a physically or psychologically 
uncomfortable situation: that there would be situations where 
stylus entry of data was simply more comfortable than using a 
laptop. Our professor is uncomfortable taking notes on a laptop 
while a student is speaking because it is intrusive; a small unit 
with handwriting recognition is not nearly as threatening. 

Everyone, myself included, was struck by the quality of the 
handwriting recognition. Programs that exploit this effectively 
will do well. However, the key word here is effectively. Stylus 
entry in the hands of a good typist is still slower than typing, 
but stylus input in an electronic form or as an input option will 
be welcome. I think that my previously mentioned concept of 
“bursts” of data entry is a good one to keep in mind for 
handwriting recognition. 

Particularly in the vertical market area, keep in mind that the 
Newton has a very powerful microprocessor and Newtonscript 
has a wide variety of built in functions. Developers should 
remember that the Newton can do some serious data crunching 
once it has received the data. 

Intelligent Assistance services should not be overlooked; the 
value of your application may be well enhanced by providing a 
good interface to Assistance and allowing the user to experience 
your program and the Newton working together to make the task 
easier. 

Finally, the Newton is an information appliance. The 
ability of the Newton to network is critical; this will allow it to 
be a front end for many data engines. Similarly, the ability to 
accept PC cards promotes the concept of the Newton Book, a 
very appealing concept in both the vertical and horizontal 
markets. One caveat here is to remember that the Newton, 
even the MP2000, is not a great graphics machine. My project 
manager friend was lukewarm about the MP2000 because his 
world of flow charts and graphs was not well supported on the 
small (to him, tiny) monochrome screen. 

So, at the risk of incredible hubris, | would like to make 
some specific observations about development opportunities in 
both the horizontal and vertical market world. I admit they are 
idiosyncratic and may be wrong; I mean to stimulate thought, 
discourse, and more complete evaluation of opportunities by 
people wiser than I. Take note of the fact that some of these 
niches already have residents, but there is certainly room for 
more good programs. 


HORIZONTAL MARKETS 

I think the keys here will be connectivity, better mousetraps, 
and the Newton as information appliance. 

Connectivity; Many users will want to tear off a chunk of a 
project, take it on the road, work on it, and then reintegrate it 
into the desktop. The user will typically be using a shrink 
wrapped desktop application for his or her efforts writing, 
number crunching, etc. There will need to be applications on 
the Newton and translators on the Mac (or Windows) desktop 
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machine that can take a Word document, for example, send it off 
to the Newton and return the new document to Word format 
with formatting intact. The bright idea formulated in seat 23A on 
the red eye back to Boston will have to be integrated into a 
desktop application; the ability to pour a Newton outline or 
Newton sketch into PowerPoint or Canvas would be welcome. 
An application to take a Newton audio recording and pass it 
through voice recognition software on a desktop machine begs 
to be written. Thus, connectivity is not simply good backup; it is 
the ability to seamlessly integrate information developed 
independently on the Newton into the appropriate desktop 
application. 

Better mousetraps: The Newton ships with a number of 
productivity applications. A better version of a Notes 
application may sell it if its price point is good and it offers 
more than incremental benefit from the purchase. Developer, 
beware: you may hit a gold mine or the La Brea tar pits. My 
caveat notwithstanding, good Newton organizational software 
that connects with existing (or new) desktop organizational 
software will sell. 

Information Appliance: The Newton has a future as a 
client of information servers. In this area, the horizontal market 
is defined as email and Web access. Applications that provide 





NEWTON? GET SERIOUS! 


quality access to these basic services will be welcome. Ir 
particular, I was struck by the need for two desktop-Newtor 
interactive applications. First, an email message should be able 
to be rejected by the Newton if it is not appropriate for the 
Newton. As an example, I may want to check my mail when ] 
am away from my desktop computer. However, I do not want 
to download a message that has attached a 1 meg Mac 
executable. Second, the Newton is not a graphics machine and 
it has a small screen. Most of the web pages I hit were awful 
looking and hard to navigate on the MP2000. I would love to 
see clients and hosts able to query each other as to graphics 
capabilities, size of screen, etc. and direct the browser to a web 
page that looks and feels right on the client computer. Finally, I 
would like to see the Newton able to interface into some 
common local network messaging/email systems so that an 
ethernet equipped Newton could tap into the corporate mail 
system and be an effective client. 


VERTICAL MARKETS 


The key concepts here are remote data collection and 
processing, and information appliance. There are many 
scenarios in business, sales, inventory management, and 
scientific investigation where a device such as a Newton 
MP2000 could be extremely useful. I showed the unit to 
someone who is in soils analysis, and he immediately saw 
utility for on-site collection of information. I can envision a 
route driver collecting inventory information at a convenience 
store, linking to the home office computer, registering the 
driver’s sale to the store, and generating an invoice for the 
store. The opportunities are endless. 

With respect to information appliance function, I think the 
Newton Book concept will be very appealing in technical and 
scientific fields. Medical information begs for Book format. In- 
house technical manuals and textual databases also are appealing 
targets for development. Finally, with the MP2000’s ability to 
connect to a network, the capability to act as a smart (or dumb, as 
the case may be) terminal may be of significant value. 


OPPORTUNITIES ARE ENDLESS 


I hope that I have justified my enthusiasm. There is a natural 
affinity of Newtons for MacOS computers. This is an opportunity 
not only to develop successfully for the Newton, it is an 
opportunity to encourage connection to our favorite desktop. 

The clever language, the powerful hardware platform, and 
the friendly development environment should support your 
efforts well. There is an untapped, undefined market out there. 
Strike while the iron is hot! 


Products Reviewed in this Article 

Newton MessagePad 2000, Apple Computer. Available first 
quarter 1997. 

Multiple configurations will be available; check retailers. 

Newton Toolkit, version 1.6.3. Apple Computer, 1996. 
Available through APDA and Developer’s Depot. 
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rder directly from web 


wnload the architectural overview or view it on-line with Adobe rVagojeyelme me) 


e most powerful object-oriented database engine available 


While others promise cross-platform — NeoAccess 
delivers. NeoAccess is a set of C++ classes designed for 
use with popular compilers and frameworks on Windows , 
Macintosh’, and Unix’ platforms. Thousands of developers, 
including America Online® and Claris®, have already 
found that NeoAccess enabled them to build fast, powerful 
internet applications in record time. That’s why there are 
more NeoAccess based applications on end-user 
machines than any other object database backend. 


oAccess® displays electrifying performance —up to 
times that of the competition. Behind its elegant 

ygramming interface is a fully optimized relational 

ery engine built for speed. It also has an object cache 

h automatic garbage collection so your applications 
run in a much smaller memory footprint than you 

sr imagined possible. And NeoAccess has no runtime 

§ SO you pay one affordable price no matter how many 

pies of your application you use or sell. 


The IDE will shortly be completing an upgrade to support fully 
the MP2000; NTK 1.6.3 still had some outstanding debugging issues 
which should be resolved by the time this article is in print. 

Newton Programmer’s Guide, Apple Computer, 1996. 
Addison Wesley Publishing Company. ISBN 0-201-47947-8. 

The definitive guide to the OS and API. 

Programming for the Newton Using Macintosh, 2nd Edition. 
Julie McKeehan and Neil Rhodes. Academic Press, 1996. ISBN 0- 
12-484832-X. 

This is a terrific book for getting started. It is clear, clever, 
and concise. Check out the CD! 

Newton Developer CD (#11) Apple Computer, November, 
1996. 

One piece of a variety of support programs for the Newton; 
any serious developer will subscribe. 


UsgEFuL URLs 
<http://devworld.apple.com/dev/newton/tools/ntk.html> You can 
download a demo version of the Newton Toolkit, without 
documentation, from here; further up the directory is the Apple 
Developer World Newton site (.../dev/newton). 
<http://www.newton.apple.com/newton/newton.html> Apple's 
Newton Home Page. 
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M-F 9AM to 5PM Pacific: 
1-800-919-6353 
For Information and Customer Service: 


1-510-524-5897 
neo-logic 


NeoLogic Systems, Inc. 

1450 Fourth St., Suite 12, Berkeley, CA 94710 
V. 510.524.5897 f. 510.524.4501 
neologic@neologic.com 





<http://www.newton.apple.com/newton/othersites.htm|> Links to 
most Newton web sites. Lots of good links here. 

chttp://www.amug.org/amug/sigs/newton/amug_newton.html> 
Granddaddy of the Newton users groups. 

<http://www.nsbasic.com/> Newton Basic Home Page. 

<http://web.xplain.com/mactech.com/Articles/Indices/Topic.Index/ 
N-Topics/text.html>. WML 





Want to know what products 
are available for MacOS 


development? Check out 
Developer Depot’ 
<http://www.devdepot.com> 
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The Tao of Design 





Using Design Patterns to 
belp reuse the structure 
of your code 


THE TAO 

I know what you’re thinking... not 
another “Eastern Mysticism as applied to 
Object Oriented Programming” article. Don’t 
worry, although I’m going to begin with an 
eastern mysticism example, I'll spend most 
of the article presenting real examples of 
design patterns in C++. You’re now 
probably wondering what is a design 
pattern? To answer that question we need to 
consider Tai Chi, Fibonocci, and the Tao. 

I used to study Tai Chi, a martial art 
and a philosophy towards life. As I was 
learning the “form” (a series of body 
positions) my teacher would often tell us 
stories that illustrated the principals of Tai 
Chi. One day he began talking about 
Fibonocci. This mathematician and 
philosopher studied Nature and numbers. 
What he discovered, and Mandelbrot later 
refined, was that nature was really into 
reuse. There are patterns to both numbers 
and organisms. My teacher related 
Fibonocci sequences to Tai Chi by pointing 
out the many patterns within the form: how 
large movements are built from similar 
small movements in a Fibonocci sequence, 
how positions repeated in slight variations, 
and so on. It was all rather enlightening. 
What of the Tao? The Tao-te Ching roughly 


translates into “the way.” It is the essential unifying element of all 
that is. It is a way of perception and living, as are using design 
patterns. Once you grasp the concept of design patterns you will 
see how and where to apply them. In essence, you'll be living 
the Tao of Design. 

Design patterns are an attempt to express the sameness of 
design solutions in object oriented programs. It is really a way of 
thinking about a problem and the design of that problem’s 
solution. Think about your own programming style. A large 
portion of it is most likely the way you structure your solutions, 
rather than the minute details of your code. If you could reuse 
the structure from one project to the next, you would gain all of 
the benefits of reuse (savings of time, higher quality, etc.) on a 
larger scale than simply reusing classes or functions. This is the 
central premise behind the book “Design Patterns” by Erich 
Gamma, Richard Helm, Ralph Johnson, and John Vlissides. 


DESIGN PATTERNS 

The book is an attempt to present the concept behind design 
patterns and describe several patterns that you can use. It is not 
intended as an introductory text on object oriented programming! 
The authors state up front that you should be proficient in at least 
one object oriented language (the examples are in Smalltalk and 
C++), and that you have object oriented design experience. To 
understand the book you must be familiar with such concepts as 
types, polymorphism, and interface versus implementation 
inheritance. This is not a light book. If you don’t know object 
oriented design this is not the place to start. If, on the other hand, 
you have been involved with object oriented design and/or 
programming and feel that you could get more reuse or elegance 
out of your efforts, this is precisely the place to start. 

The book begins with a description of the concept of design 
patterns and the motivation for using them. The idea is sound. 
We all reuse our own personal set of design solutions that we’ve 
built up through years of experience. We should study those 
solutions to discover the patterns within them, and then 
formalize those patterns into reusable classes. 


John Schettino is an author and Senior Member of the Technical Staff at GTE Laboratories, Inc. He is the co-author of the 
books BASIC for the Newton: Programming for the Newton with NS BASIC and AppleScript Applications: Building Applications 
with FaceSpan and AppleScript, both published by AP Professional. He is also a contributing editor for the Handheld Systems 
Journal and for the web eZine Mobilis, where he writes about Newton programming. You can reach him via 


http://members.aol.com/pdcjohns. 
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What the authors propose is that we develop a common way 
of referring to and specifying designs. Not only do they propose it, 
they then give a detailed example of how to apply design patterns 
in an application. The example is somewhat academic, as is the 
entire book, but don’t let that stop you from learning from it. 
Following the example are the 23 patterns themselves. They are 
organized into three categories: creational, structural, and 
behavioral. Each category contains several patterns. 

Creational patterns abstract the instantiation process. When 
you are designing complex object oriented systems you often rely 
on composite objects along with class-based inheritance. 
Creational patterns are used to delegate instantiation, abstract 
behavior, and hide instantiation and composition details. 

Structural patterns focus on the composition of classes and 
objects into larger structures. They deal with run-time 
compositions that are more dynamic than traditional multiple 
inheritance, object sharing and interface adaptation, and dynamic 
addition of responsibilities to objects. 

Behavioral patterns deal with encapsulating algorithms and 
managing or delegating responsibility among objects. They focus 
more on communication and interaction, dynamic interfaces, 
object composition, and object dependency. 

Many design problems fall into one or more of these categories. 
Typically, one must create several objects to represent the data in a 
design and decide how those objects interact and behave. When 
design patterns are applied to these problems you create more 
general, extensible, and reusable solutions than you might otherwise 
have done. You're not doing this extra work simply to feel good 
about yourself, You're helping yourself in the future when you must 
maintain this code or solve a similar problem. 

Each pattern is described from several perspectives: 

e Intent: a description of the purpose the pattern serves. 

¢ Also Known As: common names used for the pattern, such as 
Wrapper instead of Adapter. 

e Motivation: why you would use the pattern. 

e Applicability: when to use the pattern. 

© Structure: one or more diagrams describing the classes in the 
pattern and how they relate. 

° Participants: a description of each of the classes used in the 
Structure section. 

© Collaborations: a description of the run-time interaction 
between instances of the classes used in the Structure section. 

¢ Consequences: a description of the trade-offs and issues with 
using the pattern. 

¢ Implementation: a description of the implementation issues. 
The authors tell you what to avoid and what to consider 
when implementing a pattern. 

¢ Sample Code: implementations of classes illustrating the 
pattern in Smalltalk and C++. 

e Know Uses: a description of some well-known commercial 
and academic applications, toolkits, and languages that use 
the pattern. 

° Related Patterns: a list of the patterns that may be 
implemented by, use, or interact with this pattern. 
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The authors close each section with a discussion of the type 
of problems the category of patterns is attempting to solve. This 
section is most useful to those with limited design experience. 
Old hands will find that they can think of many situations where 
they could (or perhaps already do) apply the patterns. 

You'll gain three new skills from reading the book. First, you'll 
know more about design patterns themselves. You'll even know 
how to identify and classify them. Second, you'll know the patterns 
and classes presented. This can act as a standard nomenclature 
when you're discussing designs with other programmers. T hird, 
you'll have 23 patterns to use in your own programs. Some of these 
you will have already discovered yourself while others will probably 
be complete revelations to you. 


PATTERNS IN ACTION 

Let’s put the principals of design patterns into action. 
Illustrating all 23 patterns presented in the book is beyond the 
scope of this article, but I'll present an example that applies a 
pattern from each category to help motivate you to explore the 
topic further. Since these are design patterns, we need a problem 
to solve. I'm going to take the easy road and select a completely 
made-up problem — tree manipulation. We will build two tree 
structures containing file names found in a Macintosh file 
directory and perform some operations on it. 


Problem Statement 

The program traverses a Macintosh file directory and the 
subdirectories in it to create a single tree structure containing all 
the names of the files and folders visited. The names are then 
retrieved by traversing the tree. 

This is not exactly rocket science. There are plenty of ways 
of doing this without resorting to objects at all, let alone the 
design patterns described in the book. The example is simple so 
that you can focus on applying the patterns. 


Design 

We are talking about design patterns, so let’s begin with a 
design before we start coding. We want some form of tree that 
consists of nodes representing the file names. Using a tree is an 
easy way to get a sorted list. To abstract the building process 
we'll apply a creational pattern called Builder. This allows us to 
hide the internal structure of the tree being built, and to build 
different types of trees using the same program. 

Once the trees are built we must access them to retrieve the 
file names. A behavioral pattern called Iterator allows us to 
encapsulate the access algorithm such that the main program 
does not know the tree structure or the algorithm used to traverse 
the tree. This is in contrast to the more common recursive tree 
walking algorithms you’d consider first. Using an Iterator to 
traverse trees means you have to use stacks and queues to 
maintain your current location. Rather than implement our own 
stack and queue objects, we can take advantage of a structural 
pattern called Adapter to extend a list object to include the 
additional behaviors of a stack and a queue. We'll take advantage 


THE TAO OF DESIGN El 


Distribute Your Software 


Electronically and Get Paid! 





COPOHSOHSHSHOHSHSHHSHOHSHSHSHSHSHSHSHSHHHHHSHHHHSHSHSHSHSHHSHSHSHSHSHHSHHHHHHHHHHHHHSHHHSHSHSHHHHHHHHHHHHHHHHHHHHHHHEE 


PACE Software authorization systems let you: 


* Create fully functional time- or launch-limited “trialware” 


without changing your source code 


+ Distribute via the Internet, CD-ROM, BBS, floppies and more 


* Unlock software with flexibility and security 


- Add registration-capture to your software without writing code 





; Integrate registration and authorization with 


Want to try out our system on your software? ate 297-7444 





or send email to sales@paceap.cor 


of several templated classes from the C++ Standard Template 
Library (STL) for this. 

We'll use three classes for the project. The first class 
hierarchy represents nodes in the tree. The TreeNode base class 
defines the common interface for our tree nodes and a subclass 
implements a simple binary tree node. This isn’t a design pattern 
— just good object oriented design. The second class hierarchy is 
for a Treelterator class that retrieves the nodes of a tree. Two 
subclasses of the Treelterator class implement epee and 
breadth-first traversals of the tree. 

Finally, the TreeBuilder class hierarchy builds trees consisting 
of TreeNodes. One subclass of this class builds binary trees, the 
other builds height-balanced binary trees. The main program uses 
instances of both TreeBuilder subclasses to create two different 
trees containing instances of the TreeNode class. It then retrieves 
and prints the file names from each tree using instances of both of 
the Treelterator classes. It performs all these operations without 
explicit knowledge of the internal representations of the trees or 
the algorithms used to traverse them. 


Patterns 

Three patterns are used in the design: Iterator, Adapter, and 
Builder. Let me summarize each of these patterns and how they 
are applied to the problem. 

An Iterator is an example of a behavioral pattern. It is a class 
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that is instantiated with a compound data structure. Each time you 
call a member function of the instance it returns the next element of 
the structure. A null value is returned once all elements have been 
accessed. In our project a tree consisting of several nodes is the 
compound data structure. The elements returned are the nodes in 
the tree. We use the Iterator to encapsulate the tree traversal 
algorithm in a class and remove that code from our main program. 
That means the main program does not know how the tree is 
organized. It isn’t changed if the tree implementation changes or if 
we discover a more efficient algorithm for traversing the tree. 

An Adapter is an example of a structural pattern. It adds 
new interfaces to an existing object or class to create a new 
object or class with additional behaviors. We use STL stacks and 
queues in our Treelterator subclasses. Stacks and queues must 
store elements in a list, so a list class can be adapted by adding 
new member functions such as push() and pop(). 

A Builder is an example of a creational pattern. It encapsulates 
the actual building of a composite data structure and hides the details 
of how that structure is composed by defining one or more member 
functions to add elements to the composite structure. You can create 
general purpose data collection routines that accept instances of a 
Builder class and then build different forms of the composite data 
structure. In our project the TreeBuilder class builds trees. Because 
we use a Builder we can structure the trees in many different ways 
without affecting the main program. 
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Implementing The TreeNode Class 
The TreeNode class represents a node in a tree. The base 
class defines the minimal interface for a TreeNode. 


typedef class TreeNode * TreeNodePtr; 
typedef class BinaryTreeNode * BinaryTreeNodePtr; 


class TreeNode { 
friend ostream& operator<< (ostream& os, 
TreeNode& t); 
friend ostream& operator<< (ostream& os, 
const TreeNodePtr& t); 
public: 
virtual const char * output(void) {}; 
virtual int compare (const TreeNode& otherNode) 
{}; 
:; 


All TreeNode subclasses must implement the output() and 
compare() member functions. Use output() to get a string form of 
the node suitable for printing. Use compare() to determine if this 
TreeNode is less than, equal to, or greater than another TreeNode. 
We use a class hierarchy so we can create new subclasses that 
hold more complex data in a node. 

The BinaryTreeNode subclass of TreeNode represents a node 
in a binary tree. 


class BinaryTreeNode: public TreeNode { 
public: 
BinaryTreeNode(const char *name) 
{ fname = new char[strlen(name)+1]; 
strcpy(_fname, name); 
_leftChild = _rightChild = 0; } 
virtual const char* output (void) 
{ return _fname; } 
virtual int compare (const BinaryTreeNode& 
otherNode) 
{ return strcemp(_fname, otherNode._fname); } 
void setLeftChild(const BinaryTreeNodePtr 1) 
(| tlertChild = 1s ] 
void setRightChild(const BinaryTreeNodePtr r) 
{ _rightChild = r; 
BinaryTreeNodePtr leftChild() 
{ return _leftChild; } 
BinaryTreeNodePtr rightChild() 
{ return _rightChild; } 
private: 
char *_fname; 
BinaryTreeNodePtr _leftChild; 
BinaryTreeNodePtr _rightChild; 
bi 


It uses a string stored in _fname as the node value. The 
output() member function simply returns _fname. The compare() 
member function used stremp() to compare the values of the two 
nodes. We also define member functions to get and set the left 
and right child pointers stored in the node. This allows other 
classes to build and traverse trees consisting of these nodes. 


Implementing The TreeNodelterator Class 

The TreeNodelterator class hierarchy implements the Iterator 
design pattern. It is a class that is instantiated with a compound 
data structure. Each time you call a member function of an 
instance of this class it returns the next node of the tree. The base 
class defines the interface. 
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class TreeNodelterator { 


public: 
virtual TreeNodePtr operatort+ (int) {};//next 
virtual TreeNodePtr current() {}; //getcurrent 
virtual TreeNodePtr next() {}; //getnext 
virtual void reset() {}; // reset 


he 


This class implements both the ++ increment operator and 
the current() and next() member functions to retrieve nodes in the 
tree. It also includes a reset() member function so the same 
Iterator can be used to extract elements multiple times. We use a 
class hierarchy so we can provide two ways of iterating through 
the tree. The DFTreeNodelterator subclass implements a depth- 
first access of the tree. This retrieves nodes in sorted order if it is 
accessing a binary tree. 

The DFTreeNodelterator returns nodes in sorted order. 

// Depth-First BinaryTree Node Iterator 
class DFTreeNodeIterator : public TreeNodelIterator { 
public: 
DFTreeNodeIterator(BinaryTreeNode &tree) ; 
virtual TreeNodePtr operatortt (int); 
virtual TreeNodePtr current(); 
virtual TreeNodePtr next(); 
virtual void reset(); 
private: 
BinaryTreeNode *_origTree, *_tree; 
// use an STL Stack 


stack<list<BinaryTreeNodePtr> > _pendingNodes; 
void _pushLeft() ; 


The private members of the class add a couple of pointers to 
nodes in the tree. The *_origTree pointer holds the root node of 
the tree used to instantiate the iterator. This is used to reset the 
iterator. The *_tree pointer points to the current node in the tree. 
A STL stack (_pendingNodes) is used to hold the pending nodes 
as the tree is traversed. This is similar to using the program stack 
in a recursive traversal of the tree. Finally, a member function 
that pushes nodes onto the stack is declared. Let’s look at the 
implementation of the member functions next. 

// — DFTreeNodelterator member functions — 


DFTreeNodelterator:: 
DFTreeNodeIterator(BinaryTreeNode &tree) 
{ 


_origTree = _tree = &tree; 
_pushLeft(); 
} 


The constructor takes a BinaryTreeNode as its only 
parameter. The two pointers stored in the are initialized to this 
value. Then the _pushLeft() member function is used to set the 
_tree pointer to the first node to return. The iterator is now ready 
to return successive nodes of the tree. 


void 
DFTreeNodelIterator: :_pushLeft () 
{ 
while (_tree->leftChild()) 
{ 
_pendingNodes.push(_tree) ; 
_tree = _tree->leftChild(); 
} 
} 
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The _pushLeft() member function traverses the tree to the 
leaf node on the left hand side, pushing each visited node onto 
the _pendingNodes stack. Once the end of the tree is reached that 
node is consider the current node. Let’s look at the three member 
functions that return nodes. 


TreeNodePtr 
DFTreeNodeIterator::operatort+t (int) 
{ 

TreeNode* theNode = current(); 

next (); 

return theNode; 


} 


The ++ operator retrieves the current node, moves the to the 
next node, and then returns the current node. This acts just like 
the postfix ++ operator in C++. 


TreeNodePtr 
DFTreeNodelterator::current () 
{ 

return _tree; 


Because _tree always points to the current node in the tree, 
the current() member function just returns it. 


TreeNodePtr 
DFTreeNodelterator: :next () 
{ 
if (_tree) 
{ 
// follow right child ptr 
if (_tree->rightChild()) 
{ 
_tree = _tree->rightChild(); 
_pushLeft () ; 
} 
else if (_pendingNodes.size() > 0) 
{ 


// end of branch, pop and return node itself 
_tree = _pendingNodes.top(); 
_pendingNodes.pop(); 

} 


else 
_tree = 0; //alldone 
} 


return _tree; 


The next() member function traverses the tree to the next 
node. The current node’s right child is accessed. If it exists then 
the tree is traversed thru the left child from that node, again 
stacking up all visited nodes. If there is no right child then the 
stack is popped, and the popped node becomes the current 
node. If there are no nodes in the stack then the tree has been 
traversed completely. 


void 7 
DFTreeNodelterator::reset() 
{ 


_tree = _origTree; 
_pushLeft () ; 


The reset() member function restores _tree to the originally 
supplied value and then calls _pushLeft(). This restores the 
iterator to its initial state. 
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The BFTreeNodelterator subclass implements a breadth-first 
access of the tree. This retrieves nodes in height order (in other 
words, all nodes at height N of the tree are returned before 
moving to nodes at height N+1.) 


// Breadth-First BinaryTree Node 
class BFTreeNodelIterator : 
public: 
BFTreeNodelIterator(BinaryTreeNode &tree) ; 
virtual TreeNodePtr operatort+ (int); 
virtual TreeNodePtr current (); 
virtual TreeNodePtr next(); 
virtual void reset(); 
private: 
BinaryTreeNode *_origTree, *_tree; 
// use an STL queue 
queue<list<BinaryTreeNodePtr> > _pendingNodes; 
enum {IO0_node, 10_left, IO_right} _current; 
} 5 


public TreeNodeIterator [{ 


The private members of the class add a couple of pointers 
to nodes in the tree as was done in the other. A STL queue 
(_pendingNodes) is used to hold the pending nodes as the tree 
is traversed. Since we traverse the tree by level we use a 
queue to revisit nodes. Finally, an enumeration is used to 
keep track of the state of the current node in the retrieval 
process. The implementations of the member functions of this 
class differ somewhat from the other, because it returns nodes 
in a different order. 


// — BFTreeNodelterator member fns — 
BFTreeNodelterator:: 
BFTreeNodelterator(BinaryTreeNode &tree) 
{ 

_origTree = _tree = &tree; 

_current = I0_node; 


} 


TreeNodePtr 
BFTreeNodelIterator::operatortt (int) 
{ 

TreeNode* theNode = current(); 

next(); 

return theNode; 


} 


TreeNodePtr 
BFTreeNodelterator::current () 
{ 


if (!_tree) return 0; 


switch (_current) { 
case I0_node: 

return _tree; 
case IO left: 

return _tree->leftChild(); 
case I0_right: 

return _tree->rightChild() ; 
} 


TreeNodePtr 
BFTreeNodelterator: :next() 


BinaryTreeNodePtr c; 
switch (_current) { 
case I0_node: 
if (_tree->leftChild()) _current = I0_left; 
else if (_tree->rightChild()) 
_current = I0O_right; 
else if (_pendingNodes.size() > 0) 
{ 


_tree = _pendingNodes.front(); 
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_pendingNodes.pop(); 
_current = _tree->leftChild() ? 
I0_left : I0_right; 
} 
else _tree = 0; 
return current (); 
case 10_left: 
c = (BinaryTreeNodePtr) current(); 
if (c-PleftChild() || c->rightChild()) 
_pendingNodes.push(c) ; 
if (_tree->rightChild()) _current = I0_right; 
else if (_pendingNodes.size() > 0) 
{ 
_tree = _pendingNodes.front(); 
_pendingNodes.pop(); 
_current = _tree->leftChild() ? 
I0_left : I0_right; 
} 
else _tree = 0; 
return current (); 
case [0_right: 
c = (BinaryTreeNodePtr) current(); 
if (c->leftChild() || c->rightChild()) 
_pendingNodes.push(c) ; 
if (_pendingNodes.size() > 0) 
{ 
_tree = _pendingNodes.front(); 
_pendingNodes.pop(); 
_current = _tree->leftChild() ? 
I0_left : I0_right; 
} 
else _tree = 0; 
return current(); 
} 
} 


void 
BFTreeNodelterator::reset() 
{ 
_tree = _origTree; 
_current = IO node; 


} 


I’m not going to give a detailed explanation of these 
member functions. The basic behavior is that the root node is 
returned via current() and then its left and right children are 
returned when next() is called. As each child is returned it is 
added to a queue. Once all children of a node have been 
returned the node at the head of the queue is retrieved and then 
that node’s children are returned and queued. The result is that 
each “level” of the tree is visited and all nodes below that level 
are enqueued to be revisited. 


Implementing The TreeBuilder Class 
The TreeBuilder class hierarchy implements the Builder 

design pattern. It encapsulates the building of a composite data 
structure and hides the details of how that structure is composed 
by defining an AddNode() member function to add nodes to the 
tree. The base class defines this interface. 
// Builder for making trees - base class 
class TreeBuilder { 
public: 

virtual void AddNode(TreeNodePtr theNode) {} 

virtual TreeNodePtr GetTree() { return 0; } 
protected: 


TreeBuilder() {}; 
1 
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New nodes are added to the current tree being built by 
allocating them and passing them to the TreeBuilder AddNode() 
member function. The completed tree is returned by the GetTree() 
member function. The BinaryTreeBuilder subclass implements a 
simple binary tree. No effort is made to balance the tree. 


// Builder for making binary trees 
class BinaryTreeBuilder : 
public: 
BinaryTreeBuilder() ; 
virtual void AddNode(TreeNodePtr theNode) ; 
virtual TreeNodePtr GetTree(); 
private: 
TreeNodePtr _currentBTree; 


public TreeBuilder [ 


’ 


// — BinaryTreeBuilder member fns — 
BinaryTreeBuilder: :BinaryTreeBuilder () 
{ 


_currentBTree = 0; 


TreeNodePtr 
BinaryTreeBuilder: :GetTree() 
{ 

return _currentBTree; 


void 
BinaryTreeBuilder: :AddNode(TreeNode* theNode) 
{ 


BinaryTreeNodePtr testNode = 
(BinaryTreeNodePtr) _currentBTree; 
if (!testNode) _currentBTree = theNode; 
else 
{ 
ror Ge} 
{ 
if (((BinaryTreeNodePtr) theNode) 
->compare(*testNode) <0) 
{ 
if (testNode->leftChild() ) 
testNode = testNode->leftChild(); 
else 
{ 
testNode->setLeftChild ( 
(BinaryTreeNodePtr) theNode) ; 
return; 
} 
} 
else 
{ 
if (testNode->rightChild()) 
testNode = testNode->rightChild(); 
else 
{ 
testNode->setRightChild ( 
(BinaryTreeNodePtr) theNode) ; 
return; 


The AddNode() member function traverses the current tree, 
comparing the new node to the current node by using the 
TreeNode compare() member function. Once the correct location 
is located (i.e., a leaf node is reached) the new node is added as 
a left or right child of the leaf node. 

The HBTreeBuilder subclass builds height-balanced binary 
trees. To implement a height-balanced binary tree we restructure 
the tree as we add new nodes. 
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// Builder for making height-balanced binary trees 

class HBTreeBuilder : public TreeBuilder { 

public: 
HBTreeBuilder () ; 
virtual void AddNode(TreeNodePtr theNode) ; 
virtual TreeNodePtr GetTree(); 


private: 
TreeNodePtr _currentBTree; 


ee 


// — HBTreeBuilder member fns — 
HBTreeBuilder: :HBTreeBuilder() 


({ 


s@urrentBTree = 0; 


TreeNodePtr 
HBTreeBuilder: :GetTree() 


{ 


return _currentBTree; 


void 


HBTreeBuilder: :AddNode(TreeNode* theNode) 


{ 


BinaryTreeNodePtr testNode = 
(BinaryTreeNodePtr) _currentBTree; 
if (!testNode) _currentBTree = theNode; 
else 


{ 


BinaryTreeNodePtr grandparent = 0, parent = 0; 


for 


(33) 


if (((BinaryTreeNodePtr) theNode) 


{ 


->compare(*testNode) <0) 
if (testNode->leftChild()) 
( 


grandparent = parent; 
parent = testNode; 
testNode = testNode->leftChild(); 
} 
else 
{ 
// balance a tree with a long left chain 
if (parent && grandparent && 
!(parent->rightChild()) && 
!(testNode->rightChild() )) 
{ 
if (parent->compare(*grandparent) <0) 


grandparent ->setLeftChild(testNode) ; 


else 


grandparent ->setRightChild(testNode) ; 


parent ->setLeftChild(0) ; 
testNode->setRightChild(parent) ; 
} 
testNode->setLeftChild( 
(BinaryTreeNodePtr) theNode) ; 
return; 


if (testNode->rightChild()) 
{ 
grandparent = parent; 
parent = testNode; 
testNode = testNode->rightChild() ; 
} 
else 
{ 
// balance a tree with a long right chain 
if (parent && grandparent && 
!(parent->leftChild()) && 
! (testNode->leftChild())) 
{ 
if (parent->compare(*grandparent) <0) 


grandparent ->setLeftChild(testNode) ; 


else 


grandparent -?setRightChild(testNode) ; 


parent->setRightChild(0) ; 
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testNode->setLeftChild (parent) ; 
testNode->setRightChild ( 

(BinaryTreeNodePtr) theNode)) ; 
return; 


As in the last class, the AddNode() member function traverses 
the current tree, comparing the new node to the current node by 
using the TreeNode compare() member function. This version 
keeps track of the previous two nodes visited as the tree is 
traversed. Once the correct location is found (that is, a leaf node 
is reached) the current and previous nodes are checked to see if 
both lack a child on the opposite side. If they do, then the 
subtree from the grandparent node (that is, two nodes above the 
leaf) is re-arranged such that it forms a balanced tree when a new 
node is added. 


Implementing The Program 

We implement a few functions, including main(), to put these 
classes to use. I’m using a function from the MoreFiles 1.4.3 library 
to traverse a Macintosh directory. The IterateDirectory() function 
accepts a directory, a function pointer that is a callback function 
you write, and a void * that can be whatever you'd like to supply 
to the callback. This is perfect for a Builder! All I do is pass a 
TreeBuilder to lterateDirectory(). It will be passed along to my 
callback, where I can use it to add the file or folder name to the 
current tree. Besides the main() and my callback function, I’ve 
written two functions that use tree node iterators to print the 
nodes in a tree. 


fHinclude “Patterns.h” 
fHinclude <iostream.h> 
#include “IterateDirectory.h” 


// — ostream operators to print tree nodes — 
ostream& 
operator<< (ostream& os, const TreeNodePtré& t) 


os << *t; return os; 
} 
ostream& 
operator<< (ostream& os, TreeNode& t) 
{ 
os. <4. “E* KC t.ourputt) << “)\n"s 
return os; 


This pair of ostream operators use the output() member 
function of the TreeNode base class to print out a node in the tree. 
They can print out any subclass of TreeNode. 


// — callback for IterateDirectoryO — 
pascal 
void 
getName(const CInfoPBRec * const cpbPtr, 
Boolean *quitFlag, 
void *tbuilder) 
{ 
char *cstr = p2cstr(cpbPtr->hFileInfo.ioNamePtr) ; 
((TreeBuilder *)tbuilder) -> 
AddNode(new BinaryTreeNode(cstr)); 
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The getName() callback function is called for each name 
found by IterateDirectory(). The Pascal string version of the file 
name is converted into a C string. That string is used to allocate a 
BinaryTreeNode, which is passed to the TreeBuilder. Recall that the 
TreeBuilder instance was passed into this function by 
lterateDirectory() — we'll see where in a moment. 

// — walk a tree using the TreeNodelterator 
= walkTreel(TreeNodeIterator &treeNodes) 


cout << 
“* Fetching nodes via current/next operators\n”; 


for ( :treeNodes.current(); treeNodes.next()) 
cout << treeNodes.current() ; 
} 
// — walk a tree using the TreeNodelterator 
void walkTree2(TreeNodeIterator &treeNodes) 


cout << “* Fetching nodes via ++ operator\n”; 


while (TreeNodePtr p = treeNodest+) 
cout << p; 


The walkTree1() and walkTree2() functions take a 
TreeNodelterator and use it to access the nodes of a tree. They 
both produce the same output. They just use the two alternative 
APIs of TreeNodelterator. I personally prefer the ++ operator 
version used in walkTree2() because it looks more like C++. 
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// — main program 
void main(void) 
{ 


cout << “Building binary tree\n”; 
BinaryTreeBuilder b; 


// iterate over a directory named Example Dir 
// within the program’s current working directory 
StringPtr dir = c2pstr(“:Example Dir”); 


IterateDirectory(0,0,dir,2, getName, &b); 
TreeNodePtr myTree = 
(BinaryTreeNodePtr) b.GetTree() ; 


cout << 
“The nodes, using a depth-first iterator: \n”; 


DFTreeNodeIterator depthFirst ( 
*(BinaryTreeNodePtr)myTree) ; 
walkTreel (depthFirst) ; 


cout << 
“\nThe nodes, same iterator, alternate API:\n”; 


depthFirst.reset(); 
walkTree2(depthFirst) ; 


cout << 
“\nThe nodes, using a breadth-first “ 
<< “iterator: \n"; 


BFTreeNodelterator bredthFirst ( 


*(BinaryTreeNodePtr) myTree) ; 
walkTree2 (bredthFirst) ; 
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cout << 
“\nBuilding height balanced binary tree\n”; 


HBTreeBuilder hb; 


IterateDirectory(0,0,dir,2, getName, &hb); 
myTree = (BinaryTreeNodePtr) hb.GetTree() ; 


cout << . 
“The HB nodes, using a depth-first iterator:\n”; 


DFTreeNodeIterator depthFirstHB ( 
* (BinaryTreeNodePtr) myTree) ; 
walkTree2(depthFirstHB) ; 


cout << 
“\nThe HB nodes, using a BF iterator: \n”; 


BFTreeNodelterator bredthFirstHB ( 
* (BinaryTreeNodePtr)myTree) ; 
walkTree2(bredthFirstHB) ; 


cout << “\nDone\n”; 


The main() function first builds a binary tree version of the 
example directory by allocating a BinaryTreeBuilder object and 
passing that object to IterateDirectory(), along with a pointer to the 
callback function getName(). IterateDirectory() calls getName() with 
each matching file or directory, and supplies the BinaryTreeBuilder 
object. Once all the entries are processed the completed tree is 
extracted by calling the GetTree() member function of the 
BinaryTreeBuilder object. The tree is used in the constructor for a 
DFTreeNodelterator and the resulting object is passed to each of 
the walkTree functions. Notice that we reset the iterator before 
passing it to the second walkTree function. 

The whole process is repeated a second time. The only 
difference is that we create a HBTreeBuilder object to build a 
height-balanced binary tree. The example directory and program 
output are shown in Figure 1. 







== Example Dir 2=@2 
Siterns 93.2 MBin disk 





















Folder 1 
Gey Fri 
fey Jaki 
Vv Folder 2 
fy Jan 
=} Mar 
Vv Folder 3 


Figure 1. Program Output. 
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Building binary tree 
The nodes, using a depth-first: 
* Fetching nodes via current/next operators 


[ 

Bee 3] 
[Fri] 
[ 
[ 
[ 


The nodes, same iterator, alternate API: 
* Fetching nodes via t+ operator 


[ 
[ 
[ 
[Fri] 
[ 
[ 
[ 


The nodes, using a breadth-first iterator: 
* Fetching nodes via t+ operator 

[Folder 1 

Fri] 


Jaki] 


Mar] 


Building height balanced binary tree 
The HB nodes, using a depth-first iterator: 
* Fetching nodes via ++ operator 


[ 

ae 3] 
[Fri} 
[ 
[ 
[ 


The HB nodes, using a BF iterator: 
* Fetching nodes via ++ operator 
[Folder 1 

Fri] 

Folder 3] 


FolderHelp] 
Jaki] 


[ 

| 

Bee 2) 
[ 

[Mar | 


Note that although both the binary and height-balanced 
trees produce the same output when accessed via the depth-first, 
they produce different output with a breadth-first. That’s because 
the two trees are organized differently. 


DESIGN PATTERNS, MADE EASY 

I use the Standard Template Library stack, queue, and list 
objects in the class implementations. The STL (with 
documentation) is provided with recent versions of CodeWarrior. 
I mention this because the STL implements several important 
design patterns as templated classes, and is itself very dependent 
on design patterns. The stack and queue class templates are 
examples of the Adapter design pattern. They add new interfaces 
(such as the stack push() and pop() and the queue top() methods) 
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to an existing object (the list) to create new objects. You can 
learn quite a bit about design patterns simply by reading about 
the STL. 


TAO, REVISITED 

Applying design patterns to a design makes major impacts to 
both the design and the implementation. Let me point out exactly 
what those impacts are in the example program. 

We used a TreeBuilder class (an example of the Builder 
creational pattern) to construct our tree of file names. That 
moved the code (and algorithm, since we used subclasses) out of 
our main program and into a class. Our main program is simpler, 
and can build many different kinds of trees. We also gain a 
reusable TreeBuilder class just in case we ever want to build these 
or similar types of trees again. 

We used the TreeNodelterator class (an example of the 
behavioral pattern) to retrieve the nodes from the tree. T his 
allows us to move the implementation (and algorithm) for 
accessing tree nodes from the application into the class. We 
could use a TreeNodelterator to access each node of the tree and 
do whatever we want to the node. For example we might search 
the tree for a particular file name using the iterator. 

We used STL stacks and queues (examples of the Adapter 
structural pattern) within our TreeNodelterator subclasses. This 
allowed us to quickly and easily extend an existing class (the STL 
list) to provide new behavior specific to a stack and queue. 
Adapters are an excellent way to reuse trusted and debugged 
code. They simply add new behavior in the form of new member 
functions to an existing class. 

Is this just good object oriented programming? Sort of. Good 
object oriented designers would almost certainly create a TreeNode 
class hierarchy. Since we applied design patterns we ended up with 
a main program that is structured a little differently than the obvious 
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non-pattern approach to design. We also encapsulated the building 
and accessing algorithms in class hierarchies. This makes the 
classes smarter, and frees the main program from the details of the 
tree organization. We get more general (and therefore more 
reusable) classes and a simpler main program. 

I hope I’ve been able to interest you in the who area of 
design patterns. This is not just an academic area of study. You 
can make real improvements to your designs and gain real 
productivity advances in maintaining and reusing code. All you 
have to do is look at the problem with patterns in mind. 
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Using SOM to Extend Your OpenDoc Parts 





An introduction to SOM and 
OpenDoc extensions with 
an overview of Apple’s 
ScriptRunner sample code 


With the release of OpenDoc, version 1 
(DR4) in January 1996, Apple provided the 
developer community with a powerful tool 
for creating interchangeable software 
modules. The good news is that component 
parts for use inside of applications such as 
Microsoft Excel and ClarisWorks can be 
produced quickly using the tools provided. 
Further, the OpenDoc Frameworks Library 
(ODF) is definitely a step in the right 
direction — providing tools to take care of 
routine graphic interfacing. 

Unfortunately, OpenDoc parts are 
optimized for responding to menu and user 
events and cannot easily communicate with 
each other directly. The problem is 
summarized on p.69 of the OpenDoc 
Programmer's Guide. “The _ basic 
architecture of OpenDoc is primarily 
geared toward mediating the geometric 
interrelationships among parts, their 
sharing of user events, and their sharing of 
storage. Direct communications among 
parts for other purposes than frame 
negotiation is mostly beyond the basic 
intention of OpenDoc. If separate parts in a 
document (or across documents) need to 


share information, or if one part needs to manipulate the 

contents or behavior of another part, you need to extend the 

capabilities of OpenDoc in some way.” 

Translated, this says that you cannot conveniently pass 
parameters to and from a part without adding extension 
subclasses. To do this, you must write and compile SOM idl files. 
Fortunately writing, modifying and compiling idl files is not 
difficult as we will show in this article. 

In this article we approach the subject of OpenDoc 
extensions in the following way. 

1. Explain what extensions are. 

2. Provide a glossary of some of the common terms we will be 
using in this article. 

3. Show how extensions work by providing a detailed 
description of Apple’s ScriptRunner demo. This will also 
show how to use lists, shared resources and shell plug-ins. 

4. Outline and build a simple example which will show how to 
write the necessary code for implementing a minimal extension. 

5. Provide instructions for compiling the files by executing the 
SOM compiler from within Apple’s MPW Shell program or 
the ToolServer. 


EXTENSIONS 

What are these magic things called extensions? First, we 
consulted Chapter 10 of the OpenDoc Programmer’s Guide 
and determined that OpenDoc uses the extension mechanism 
for the following: | 
e Expanding the object interface. 
e Creating custom event types. 
e Creating custom focus types. 
e Supporting scripting. 
e Customizing information returned by the Part Info dialog box. 


Gerry Kenner is a researcher at the University of Utah, Salt Lake City, UT. His major goal is developing better methods for 
doing program design. David Kenner is a Macintosh programmer at Phone Directories, Orem, UT. Deborah Grits is a 
Developer Technical Support engineer at Apple Computer. They can be reached via email at Gerry.Kenner@m.cc.utah.edu and 


DKenner@phonedir.com. 
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Also, extensions can be used for graphical transformations, 
creating shell plug-ins and writing OpenDoc patches. 

These things are possible because all subclasses of class 
ODObject can be extended using subclasses of the ODExtension 
class. 

Extensions operate by providing an interface to a part which 
can be accessed by other parts. The extension has methods 
which when called will relay the call to the corresponding 
methods of the parent classes. 

Figure 1 shows how this works for the ScriptRunner example. 








TextEditor :: 











SOM Message 3 HandleEvent 7 
HandleMenuE vent 





PaletteExt:: ScriptRunner :: 





fOwner 
ShowPalette 


Figure 1, The HandleMenuEvent method of the TextEditor 
object can access the Show method of the ScriptRunner object 
thru the PaletteExt object, which is a subclass of ODExtension. 


Some OpenDoc Terminology 

Here are some terms used in the material that follows: 
Name space 

Object (or list) which maps data types to values. If 
published, name spaces can be used globally. 
Plug-in module 

Shared libraries which must be installed when a document 
which has parts that use them is first opened. They modify or 
extend the functions of the document shell. They are not 
ODExtension subclasses. 
Document shell or document shell program 

Managing the environment of the parts in a document. 
Extension 

Mechanism for expanding the functionality of the 
OpenDoc classes. 
Agent 

Code for performing tasks such as instantiating an object. 


ScriptRunner Project 

Apple included a project in the version 1.0 release of 
OpenDoc (Developer Release 4) named ScriptRunner. The 
function of ScriptRunner was to demonstrate how to program 
and use extensions and plug-ins. ScriptRunner was designed to 
enhance the capabilities of another Apple Demo part, TextEdit, 
by adding a palette with scripting functions. 

ScriptRunner has several components, an OSA plug-in, a 
data transfer extension, a scripting palette extension and the 
ScriptRunner part. The interrelationship between the components 
and the TextEdit part is shown in Figure 2. 


APRIL 1997 @® MACTECHMAGAZINE 







edo 'iV(=) am \ViF-lomr-lale 
Macintosh 
B= \V(-)[o) o[=1 gs 


FIND OUT FAST 
IN MEMORY 


THE MEMORY MINE 


i See memory allocation in any open heap at a glance. 
iw Easily soot memory leaks. 
ww» Flags heap corruption when it happens. 


» Stress applications on the fly with Purge, Compact, and Zap. 
i Allocate memory at will for precise stress testing. 
=» Log heap data - easily document heap status over time. 


wm No need for source code: nothing inserted in code; no patches 
to the system. 


i Works with 24-bit, 32-bit, and modern memory managers. 
For Macs with 68020 or better. Requires System 7.0 or later. 


only $99 US 
Order now from Adianta, Inc. 


Phone: (415)781-8052 ¢ FAX: (415)781-8053 
AOL:Adianta ¢ Internet:adianta@ aol.com 

For VISA, MC, or American Express orders by mail, fax, or Internet, please include 

name, address, card number, expiration date, and phone number or email address. 


Also available through APDA and the MacTech Mail Order Store. 
for more information contact 
Adianta, Inc. ¢ 582 Market St. #911 ¢ San Francisco, CA 94104 



























Name Space 


- | 


sali 
Runner ScriptRunner Agent 





4— Unload 


Acquire 
ScriptRunner 









Create Part Retrieve 


Agent 


TextEdit 
Part 
Palette Text 
Extension 
Transfer 
ext 


Figure 2. Relationships of the various components of 
the ScriptRunner system. Modified from illustration in 
Apple’s ScriptRunner Read Me document entitled 
“ScriptRunner Mechanics.” 
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ScriptRunner operates as follows. The TextEdit part is opened 
and the user either types or pastes an Apple script into the active 
text window. The menu item “Show ScriptRunner” of the Tools 
menu is then selected (Figure 3). The ScriptRunner part is 
instantiated and the ScriptRunner palette appears in the document 
window. Selection of the Run item of the palette results in 
execution of the script contained in the text window. At the end of 
execution, a dialog box appears with the results returned by the 
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WHAT'S GOING ON 


iw Works with source level debuggers to let you find memory problems fast. 


AppleScript. It will read “No results” if nothing is returned. As of 
DR4, the record function had not been implemented. 


= Document Edit Font Size Style Format Tools 


TextEditor 1.0 1 





Figure 3. Window of TextEditor at the completion of an 
execution cycle of the Run command of ScriptRunner. 


Now that the reader understands how ScriptRunner is called 
and what it does, we will show the details of the operation. For 
clarity, we will present this in several segments. 


OSA Plug-in 

Plug-ins are shared libraries which are called by the 
document shell when a document is created. When a document 
is opened, the document shell is launched by OpenDoc. The 
document shell sets up the document after which it calls the 
install methods of associated plug-ins. Once this is done, the 
shell finishes setting up the document by opening its window. 

Each shell plug-in has a single exported entry point, its 
install function. The OSA plug-in’s install function is named 
ODShellPlugInInstall. This function creates a name space for 
storing an object reference to an object of the class 
ScriptRunnerAgent. It then instantiates the object and puts its 
address in the name space (Figure 4). 
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Document Shell 
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B)nameSpMg (2) 
HasNameSpace 
EJob jNameSpace 

Register (5) 








. Create ScriptRunner Agent object pointed to by agent. 


. Store the address of the ScriptRunner agent in the name 
space. 





Figure 4. Creation of name space and ScriptRunnerAgent 
objects, followed by storage of an object reference to the 
ScriptRunnerAgent object in the name space object. 


ACCESSING SCRIPTRUNNERAGENT BY TEXTEDIT 
ScriptRunner is accessed by selecting the “Run ScriptRunner” 
item from the Tools menu. The first time this occurs, the program 
checks to see if ScriptRunner is available and then installs it 
(Figure 5). This is done by retrieving the reference to the 
ScriptRunnerAgent from the name space and using its methods to 
instantiate the ScriptRunner part. 
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5. SeriptRunner part does not exist. 7. Returns fScriptRunner ID. 

6. Instantiate the ScriptRunner object. Returns 8. Returns reference to palette extension. 


object reference named part. 





Figure 5. Sequence of events following selection of “Open 
Scriptkunner” item of tools menu. 


Accessing the palette extension 

For a client part to use another part’s extension, it calls the 
method AcquireExtension to get a reference to it. AcquireExtension 
will create a new extension object if one does not already exist 


Using the palette extension 
At this point, the palette menu is showing. Selection of the 
Run item results in the sequence of events shown in Figure 6. 
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1. Set the script to be run. 


Figure 6. Program flow when the Run item of the Palette is selected. 


EXTENSION PROJECT 


Planning Stage 
We are going to design a simple project to demonstrate how 
to write an extension which has minimal functionality. 


Business Sublevel 

Our starting point is the Image project that was described in 
the February, 1996 issue of MacTech Magazine. This project 
involved the creation of objects of two parts named ImagePart 
and SelectPart. Following instantiation, the ImagePart object 
displayed a read only text screen and had a menu option for 
selecting the name of a text file. Selection of the menu option 
resulted in the instantiation of the SelectPart object which 
automatically displayed an SFGetFile dialog box that asked for a 
file name. The SelectPart object then placed the name in global 
storage from which it was retrieved by the ImagePart object. The 
name was then displayed in the read-only window. 


Solution Sublevel 

ImagePart will be simplified by having it call the MyOpenPict 
method from its InitializeFromStorage method thus bypassing the 
menu operations. This is bad practice but it does enable getting a 
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program running quickly. The MyOpenPict method will 
instantiate a SelectPart object and call one its methods which was 
added via the extension mechanism. 

The ODExtension subclass GetNameExt will add a method 
named GetName to SelectPart. The extension will be accessed by 
ImagePart which will then call the method. The method GetName 
will display a dialog box asking for the name of a file. This is to 
provide visual evidence that calling the method was successful. 

To simplify our demo, we are not going to pass or return any 
parameters. Adding this functionality is moderately complicated 
and will make a good subject for a future article. 


Prototyping Level 

Figures 7 and 8 give the general layout for running the 
modified image program. After instantiating SelectPart, ImagePart 
will interrogate it to determine if it has the desired extension for 
getting a file name. If it is available, a call will be made to obtain 
the file name. The SelectPart object will then be disposed of and 
the ImagePart object will be displayed (Figure 7). 


Initialize 
Part 
Call 

GetName 


Figure 7. Outline of activities of the ImagePart part. 








Call 
GetFileName 
Method 









An overall outline of the operations of the SelectPart object 
is shown in Figure 8. 












Display 
SFGetFile 
Dialog Box 






Figure 8. Outline of operations of SelectPart. 


Flow Diagramming Level 

Figure 9 shows the flow of the MyOpenPict method. The 
SelectPart part is instantiated followed by the acquisition of a 
pointer to the GetNameExt extension (AcquireExtension 
method). A call is then made to the GetName method of the 
extension. Figure 10 shows the details of how the GetName 
method of the SelectPart part is called from the GetName method 
of the extension. 


ImagePart:: 
. im > 


(AJMy OpenPict 


(1)SelectPart: 
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} a)lnitPartFromSt ; i 
(initialize 









igs o z (2) AcquireExtens a 
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. “Success"on 
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Figure 9. Program flow of ImagePart/SelectPart interaction. 
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Figure 10. Execution of the GetName method. 


SOM Interface 

To get the advantages of a cross-platform development 
system, it is necessary to isolate the program code from the 
interface code. This is done in OpenDoc by writing SOM 
interface code using the IDL (Interface Definition Language) 
programming language. The interface code bridges the gap 
between SOM and high level programming languages such as 
C++ which are used to write the program proper. 

SOM has several components, the most important of which 
are the SOM kernel, the SOM class libraries and the SOM 
compiler. The kernel implements the basic runtime behavior 
while the class libraries augment the runtime environment. The 
compiler translates the IDL code into a target language such as 
Git 

The first step towards creating a part is to write a definition 
file using IDL. The file will be identified with an .IDL suffix. The 
format of a typical class definition taken from Apple’s SamplePart 
project is as follows: 


module SampleCode 
{ 
interface som_SamplePart : ODPart 


majorversion = 1; minorversion = 0; 
functionprefix = som_SamplePart__; 
override: 

somInit, 

somUninit, 

AcquireExtension, 

HasExtension, 

Purge, 

ReleaseExtension, 

etc. 


tifdef _ PRIVATE__ 
passthru C_xih = “class SamplePart;”; 


SamplePart *fPart; 
#endif //__PRIVATE__ 
he 


...More stuff that is not used on the Macintosh. 


When the .IDL file is compiled, three new files are created. 
These are a usage binding, an implementation and an 
implementation template file with extensions .xh, .xih and .cpp 
respectively. The usage binding file corresponds to a C++ header 
file. The implementation file is private to the SOM class and 
contains macros and other information needed for the class to 
have access to its instance variables and superclass methods. The 
implementation template file corresponds to a regular C++ 
implementation file. Basically, it contains stub method definitions 
which must be filled in by the programmer. 


44 UsING SOM To EXTEND YOUR OPENDOC PARTS 


{ 


Programming Level 

The following code was tested using OpenDoc release DRS, 
CodeWarrior, version 9 and System 7.5.2. Create two new OpenDoc 
part projects using PartMaker Pro. Configure them as follows. 


ImagePart 

The ImagePart part is created using Apple’s SamplePart 
template. Use the names ImagePart and KSS for class and module 
identifiers respectively. The following method is added to the 
ImagePart class and called by adding a line of code to the end of 
the InitializePartFromStorage (or InitPart) method. 


void ImagePart: :MyOpenPict (Environment *ev) 


ODPart *selectFile; 
ODStorageUnit *su; 
ODBoolean haskxt: 
KSS_GetNameExt *extension; 


su = f£Self->GetStorageUnit (ev) ; 
selectFile OL: 
selectFile = su->GetDraft(ev) 

->CreatePart(ev, kSelectPart, kODNULL) ; 
hasExt = selectFile->HasExtension(ev, kGetNameExtension) ; 
if (hasExt) 

{ 
extension = (KSS_GetNameExt*)selectFile 
->AcquireExtension(ev, kGetNameExtension) ; 
extension->GetName (ev) ; 
extension->ReleaseExtension(ev); // Not tested. 
} 


} 


This #include statement is put at the top of the ImagePart.cpp file: 


#include “GetNameExt.xh” // This can go anywhere. 


Add these lines to the ImagePart.h file. 


//-** Programmer added material ** 
public: 
void MyOpenPict (Environment *ev); 


The indicated changes are made to the ImagePartDef.h file. 


// SelectPart items 

define kSelectPartKind 

#tdefine kGetNameExtension \ 
“Apple Computer:Extension:ScriptGetName” 


“Apple:Kind:SelectPart” 


At this point, set aside the ImagePart project until the 
SelectPart project has been compiled and the SelectPart.stub and 
GetNameExt.h files have been created. 


SelectPart 

The next step is to get our ducks in line on the receiving end. 
Create the SelectPart project using Apple’s ScriptRunner template. 
Use SelectPart and KSS for class and module identifiers respectively. 
Locate the following lines of code in the SelectPart.idl file, which are 
located immediately after the following line. 


interface som_SelectPart : ODPart 


{ 
void ShowPalette(); 
void HidePalette(); 
ODBoolean IsPaletteVisible(); 
ODBoolean MovePalette(in ODPoint point); 
ODPoint* GetPaletteLocation(); 
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void SetClient(in ODPart client); 
void HandleRecordingEvent(in AEDesc script); 


and replace them with 


void GetName(); 


Now, locate the following lines immediately after releaseorder. 


CreatePalette, 
ShowPalette, 
HidePalette, 
IsPaletteVisible, 
MovePalette, 
GetPaletteLocation, 
SetClient, 
HandleRecordingEvent, 


and replace ShowPalette to HandleRecordingEvent with 


GetName, 


The finished .idl file will be as follows: 


module KSS 
{ 
interface som SelectPart : ODPart 
{ 
void GetName(); 
#ifdef _ SOMIDL _ 
implementation 


WritePartInfo; 


releaseorder: 
CreatePalette, 
GetName, 


ifdef _ PRIVATE __ 
passthru C_xih = 
“elaes SelectPart;”; 


Compile the file using the instructions given in the next section. 

When completed, you will have three output files entitled 
SelectPart.cpp, SelectPart.xh and SelectPart.xih. Replace the .xh and 
xih files in the SelectPart project source folder with the new ones. 

Do not replace the .cpp but rather open the original one 
found in the source folder and delete the methods ShowPalette, 
HidePalette, IsPaletteVisible, MovePalette, GetPaletteLocation, 
SetClient and HandleRecordingEvent. Comment out the 
command somSelf->HidePalette(ev) and associated code in the 
HandleEventWindow method. Open CScripter.cpp and comment 
out the call to HandleRecordingEvent in the method, 
RecordEventHandler. Open the new .cpp file and locate the 
GetName method. Use this code as a model for adding a 
GetName method to the original SelectPart.cpp file. The resulting 
addition should be as follows. 
SOM_Scope void SOMLINK SelectPart__GetName(KSS_SelectPart 
*somSelf, 

Environment *ev) 

| Point where; 


SFETypeList typeList; 
SFReply reply; 


KSS_SelectPartMethodDebug(“SelectPart”, ”"GetName”) ; 


where.h = 40; 
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where.v = 40; 
{ 
ODSLong rfRef; 
rfRef = BeginUsingLibraryResources() ; 
{ 
::SetCursor (&0DQDGlobals. arrow) ; 
-:SFGetFile(where, OL, OL, -1, typeList, OL, 
&reply) ; 
EndUsingLibraryResources(rfRef) ; 


Put #include “StandardFile.h’ somewhere so that SFGetFile will work. 


GetNameExt 

Locate the files PaletteExt.idl, PaletteExt.cpp, PaletteExt.xh, 
PaletteExt.xih and paletteExt.exp and change their names to 
GetNameExt.idl, GetNameExt.cpp, etc. Do a global search in the 
text of these files with an editor such as BBEdit and replace all 
instances of PaletteExt and Samples with GetNameExt and KSS 
respectively. Similarly locate and replace any instances of 
kPaletteExtension found in the SelectPart project (all the files in 
the source folder) with kGetNameExtension. We are now ready 
to modify and compile the GetNameExt.idl file. 





UsING SOM TO EXTEND YOUR OPENDOC PARTS 45 | 


Add Universal Spellchecking to 
your application for free with 


the Word Services Suite. 
¢ The Word Services Suite allows any application to link to a speller, 
grammar checker or other text service as if it is built-in. 
¢ Itis a public protocol: no license fee or nondisclosure is required. 
e Your users may purchase services in a variety of languages. 
e Services may be shared among several applications. 
¢ Word Services is easy to implement — it usually takes two days. 
¢ Itis great for in-house, homemade and vertical applications. 
e Word Services has been an industry standard on MacOS since 1992. 
¢ A BeOS version is coming soon. 
¢ It will work unmodified under MacOS 8. 
¢ It is very reliable, and patches no traps. 
¢ Client and server vendors, the protocol specification, tutorial docu- 
ments, and the source code to a client called Writeswell Jr. are at: 


http://www.wordservices.org/ 
¢ Spellcheck WSI NewsWatcher — get the source code free! 
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Locate the following lines in the GetNameExt.idl file: 


void Show() ; 

void Hide(); 

ODBoolean IsPaletteVisible(); 
ODBoolean Move(in ODPoint topleft); 
ODPoint* GetLocation() ; 

void SetClient(in ODPart client); 


Asout Osyect FLow SysTEM (OFS) 

OFS is a programming design system based on a flow 
charting program (MacFlow or WinFlow, Mainstay) and a word 
processing program with outlining capabilities. Throughout the 
development of a program, flow charts and diagrams are 
created which are linked together for easy reference. Since the 
printed output of flow charting programs is difficult to use for 
hard reference, the charts are transferred to a word processor 
where they are stored in outline form with added descriptive 
text. This facilitates the printing of the project in an organized 
manner. The organization of the material in the flow chart and 
word processing files follow the general format of this article 
starting with the section entitled Extension Project. 
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Replace them with: 


void GetName(); 


Also locate: 


releaseorder: 
Show, 
Hide, 
IsPaletteVisible, 
Move, 
GetLocation, 
SetClient; 


and replace them with: 


releaseorder: 
GetName; 


Following SOM compilation, go back to the source folder of 
the SelectPart project and replace GetNameExt.xh and 
GetNameExt.xih with the newly generated files. Open the 
SelectPart project and replace PaletteExt.cpp and Palette.exp 
with GetNameExt.cpp and GetName.exp. Open the original 
GetNameExt.cpp file and remove the code for the Show, Hide, 
IsPaletteVisible, Move, GetLocation and SetClient methods. Next 
open the new GetNameExt.cpp file and copy the code over for 
the GetName method to the original GetNameExt.cpp file. This 
code should be as follows. 

SOM_Scope void 

SOMLINK GetNameExt__GetName(Samples_GetNameExt *somSelf, 

Environment *ev) 

| Samples_GetNameExtData *somThis = 
Samples_GetNameExtGetData(somSelf) ; 


Samples_GetNameExtMethodDebug (“Samples_GetNameExt”, 
"Get NameExt__GetName”) ; 


SOM_TRY 

_fOwner ->GetName (ev) ; 
SOM_CATCH_ALL 
SOM_ENDTRY 







a six ion to beac, Thee is. a. a 
a A, +B, o ete, 1 4, 3, , . 


are written out. The relationships Sas a ‘methods and 
functions are usually shown. Notes are added for clarity. 

For further details, see the references listed in “the 
suggested reading section. 
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Compile the SelectPart project. 


SelectPart.stub 

Create a file named SelectPart.stub as follows. 

Make a copy of the SelectPart library and name it SelectPart.stub. 
Open SelectPart.stub using ResEdit. Open the ‘cfrg’ resource. 
Change the member count of the ‘cfrg’ resource to 1. 

Delete the second member of the ‘cfrg’ resource. 

Save the resource. 

Move the SelectPart.stub file to the Objects folder of the 
ImagePart project folder. Make a copy of the GetNameExt.xh 
file and move it to the source folder of the ImagePart project 
folder. Open the ImagePart project, create a category named 
SelectPart Library and add SelectPart.stub to the project. 
Compile the ImagePart project. 

Create stationary files from the ImagePart and SelectPart 
libraries. Go to the stationary folder and execute the ImagePart 
stationary. It will bring up a dialog box asking for a file name. 

At this point, you are ready to start creating your own parts 
which use customized extensions. 


le a ae 


SOM COMPILATION 

Once the requested changes have been made, the .idl files are 
compiled with MPW Shell or ToolServer. The major problem is that 
these programs do not keep track of header files. This means that 
the programmer must know what and where everything is in his 
OpenDoc project. This requirement usually overwhelms anyone 
using these programs for the first time (or the second, or the third). 

We have found that the easiest (not best) work-around for 
the directory problem, is to put everything into the main MPW 
directory. The equivalent operation with ToolServer is probably 
to place the project folder in the directory containing 
ToolServer. The best method, of course, is to become proficient 
with MPW Shell and/or ToolServer. Instructions and scripts on 
how to use ToolServer can be obtained from Symantec and 
Metrowerks. In addition, there are two articles dealing with this 
subject in recent issues of Develop. (See further reading.) 

We used the following script based on the Internet tech note 
by Jeremy Roschelle to compile our .idl files. (See further reading.) 
set SOMOUT ‘ PowerBookl:MPW:OpenDoc Projects:SOM Support’ 
set ODIDL ‘ PowerBookl:MPW:OpenDoc Projects:Interfaces:IDL’ 
set ODDIRS “-i ‘{ODIDL}’” 
set TARGET ‘ PowerBookl:MPW:OpenDoc Projects:IDL’ 


somc {ODDIRS} -p -e xih,xc,xh -o “{SOMOUT}” “ 
PowerBookl]:MPW:OpenDoc Projects: IDL:som_SamplePart.id1” 


SOMOUT is the path to where we want our output files to 
be placed. ODDIRS is the location of the OpenDoc .idl files. If 
you don’t know where to find them, search for the file 
arbitrat.idl on the OpenDoc and compiler disks and copy them 
to the above directory. TARGET was included for completeness. 
It is the pathway to your .idl source file. MPW Shell has a bug 
which prevented its use so we addressed the location of the file 
with its full path name (end of somc command line). 
SamplePartVers.h must be placed in this folder also. 
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The best high 
performance, 
portable 
compression 
libraries for 
DOS, Windows, 
OS/2, Unix, 
: Macintosh, 
embedded systems, 
and practically anything 
else, period. 


New Version 3.2 



















Robust, 45-Function API DOS $249 
Butfer and File Compression Winlé $299 
Portable Archives and Data Win32 $299 
Disk Spanning OS/2 $349 
Encryption Unix $349 
Self-Extracting Executables Macintosh $349 
On-line Help 
Full C Source Code FREE DEMO 
Tel 606-245-4175 
Fax 606-245-9305 





% DC Micro into@dcmicro.com 
x= Development http: //www.dcmicro.com 


Call 1-800-775-1073 








CONCLUSION 


And there it is. You can add an extension to your part by making 
minor changes to two .idl files. You then make further minor 
changes to the original .cpp and .h files. The resulting code will be 
stable and eventually you will be able to port across platforms. 
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Kenner, G., and D. Kenner, Object Flow System (OFS) for 
Visual C++, unpublished manuscript, 1995. (Request via email.) 

Maroney, T., ToolServer Caveats and Carping, Develop, 24 
(1995) 69-71. Wa 





UsING SOM TO EXTEND YOUR OPENDOC PARTS 


MACTECH 
ONLINE 





By Nicholas C. “nick.c” DeMello <URLs@mactech.com> 








Watch your language... 





DEFINITIVE C++ 

In 1979 a student named Bjarne Stroustrup presented a Ph.D. 
thesis entitled Communication and Control in Distributed 
Computer Systems to Cambridge University. While working on that 
thesis, and later while working at Bell Laboratories, Stroustrup 
began building the conceptual basis and C code that eventually 
evolved into his C++ language. In this column, we will explore 
some of the online resources dedicated to that language. 

Bjarne Stroustrup has a home page that presents a brief 
biography, some frequently asked questions about C++, and even a 
copy of a rather famous post Stroustrup made to comp.lang.c++ (in 
which he responded to many criticisms about C++). There’s also a 
copy of a post he made in 1983, regarding his opinions on how 
best to learn C++. Various papers and books Stroustrup has written 
are described as well. The most significant of these is The C++ 
Programming Language 2nd ed (Addison-Wesley, 1991, ISBN 0- 
201-53992-6). The first edition of this book, introduced in October 
of 1985, was the formal introduction of C++ to the world, and is still 
the definitive description of the language. An errata of that book is 
available online, as well as another essential reference to C++ — 
the working papers for the ANSI C++ standard. 

Bjarne Stroustrup’s Home Page 
<http://www.research.att.com/~bs/homepage.html> 
The C++ Programming Language Errata 
<http://sf. www. lysator.liu.se/c/bs-errata.html> 

The ANSI C++ Working Papers 
<http://www.research.att.com/c++/> 
<http://www.cygnus.com/misc/wp/> 


RESOURCES FOR LEARNING C++ 

An essential step in learning anything is reviewing the FAQs. 
C++ has been around a long time, and the FAQs are well 
understood and have been artistically compiled by Marshall Cline. 
So well compiled that the C++ FAQ, originally posted to 
comp.lang.ct+, has evolved into the C++ FAQ, a book available 
from Addison-Wesley’s developer press (by Cline and Lomow, 
Addison-Wesley, 1995, ISBN 0-201-58958-3). Marshall still 
maintains an HTML and text version of the FAQ called the C++ 
FAQ Lite. Lite is a relative term though, this document is regularly 
posted to comp.lang.ct+ in seven parts, and contains a huge 
amount of useful information (imagine how much more exists in 
the book form). You'll also find a posting of the C++ Libraries FAQ 
on comp.lang.c++ and news.answers — maintained by Nikki 
Locke. This FAQ, also available in HTML form, contains an 
extensive listing of C++ class libraries on subjects as diverse as 


Eo WATCH YOUR LANGUAGE 


processing gray scale images, developing neural networks and 

genetic algorithms, adding relational database functionality, 

garbage collecting, matrix manipulation, and MPEG decoding. 
However, FAQ’s aren’t enough. A structured tutorial is a good 

way to get started with a new language. Some excellent tutorials 

exist online, such as the C++ Annotations pages and the eight part 

Accelerated Introduction to C++. Once you have a handle on C++, 

and want to learn more about the Object Paradigm, visit the 

Introduction to Object-Oriented Programming Using C++. 

The C++ FAQ Lite 

<ftp://ftp://rtfm.mit.edu/ftp/pub/usenet-by-group/comp.lang.c++/> 

<http://www.cerfnet.com/~mpcline/C++-FAQs-Lite/> 

The C++ FAQ Book 

<http://heg-school.aw.com/cseng/authors/cline/FAQ/FAQ.htm|> 

C++ Libraries FAQ 

<ftp://rtfm.mit.edu/ftp/pub/usenet-by-group/comp.lang.c++/C++-faq/libraries/> 

<http://purl.oclc.org/NET/C++Libraries/> 

C++ Annotations 

<http://www.icce.rug.nl/docs/cpp.html> 


Understanding C++: An Accelerated Introduction 
<http://www.iftech.com/oltc/cpp/cpp0.stm> 


Introduction to Object-Oriented Programming Using C++ 
<http://uu-gna.mit.edu:800 1/uu-gna/text/cc/index.html> 


RESOURCES FOR BUILDING WITH C++ 

There is a wealth of online resources for C++ programmers. 
The C/C++ Users Group offers an extensive collection of example 
code in C and C++, accessible through indices organized by 
subject, title, platform, or author and through a search engine. The 
http home of the IRC channel #C++ also offers archives of source 
code and reference information. Another good starting point is 
Jon’s C++ Resources. Jon Morris Smith has arranged his links 
(which point to libraries, compiler specific information, book 
reviews, extensions, STL, and other resources) by geographic 
location. This will be especially useful to European readers who 
sometimes have difficulty accessing US based resources. Also 
check out Wolfgang Wanders’ Getting Informed about C++ page 
and the C++ Virtual Library for a wide selection of links. 

There are a lot of exciting things happening with OOP these 
days, but C++ is still the king of the object paradigm. There is a 
wealth of libraries, tutorials, and source available to help you make 
the most of C++. Hopefully this column has put you in touch with 
some of those resources that are available online. 

— nick.c <mailto:online@mactech.com> 
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The Law Office of Bradley M. Sniderman 


California Lawyer focusing on Intellectual 
Property, Corporate, Commercial and Contract 
law, as well as Wills and Trusts. 


If you are looking to protect your software with 
Copyright or Trademark protection, or if you need 
help establishing or maintaining your business, 
please give me a call or an e-mail. Reasonable fees. 


(310) 553-4054 
Brad@Sniderman.com 













Mac Registry™ ® 


Developer Job Opportunities 


If you are a Macintosh developer, you should register with us! 
We have a database that enables us to let you know about job 
opportunities. When we are asked to do a search by a client 
company the database is the first place we go. There is no 
charge for registering. The database service is free. Geo- 
graphic Coverage is nationwide. 





Marketability Assessment - To get a specific feel for your 
marketability send a resumé via Email or call. You may also 
request a Resume Workbook & Career Planner. 





Discreet - We are very careful to protect the confidentiality of 
a currently employed developer. 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place- 
ment services and we are Mac fanatics. 


1-800-231-5920 + das@spi.com * Fax 1-800-757-9003 
http://www.scientific.com 


Scientific Placement, Inc. 


MT, Box 19949, Houston, TX 77224, 281-496-6100 Fax: 281-496-0373 

MT, Box 71, San Ramon, CA 94583 510-733-6168 beth@spica.bdt.com 
MT, Box 202676, Austin, TX 78720-2676 512-260-0123 lej@zilker.net; 
Compuserve: 71250,3001; AOL: davesmall 


MacTech Magazine is your 


recruitment vehicle 


When you need to fill important positions at your company, MacTech 
Magazine is the consistent choice of companies across the country for 
hiring the best qualified Macintosh programmers and developers. Let 
MacTech Magazine deliver your recruit-ment message to an audience 
of over 27,000 qualified computer professionals. 


Call Ruth Subrin at 
805/494-9797 








Hevp MAKE MACTECH Work 





Here at MacTech Magazine, we tely heavily 
on outside writers for most of the material that 
appears in our pages. If readers did not 
participate in the magazine, sending us their 
ideas and taking the time to write articles, there 
would be no MacTech. MacTech Magazine is 
not a staff of writers sending a constant stream 
of one-way messages outwards; it’s a living, 
evolving network of readers conversing with 
one another, educating one another, sharing 
their knowledge, their experience, their 
interest, their trials and tribulations and joys 
and successes in the constantly unfolding story 
of programming the Macintosh. MacTech 
Magazine doesn’t just happen: it’s what the 
community makes it. If we carry reports of 
future trends and technologies, if we teach 
useful methods, if we review new books and 
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tools, if we provoke thought, provide help, 
ride the wave of current interests and 
concerns, it is only because we reflect the 
thoughts of our readers, who speak through 
our pages. 

- You are invited to involve yourself in 
this exciting conversation amongst readers. 
No matter who you are, no matter what 
your credentials may be, if you have a tale 
to tell, a trick to share, a technique to teach, 
we want you to consider joining the family 
of those who write for MacTech. 

Don’t just wait for a topic to be 
covered or a technique explained in 
MacTech! Take responsibility! Write us an 
article yourself! 

To write for MacTech, just send for our 
Writer's Kit. It’s a Microsoft Word file 


containing the Styles you need to use, and 
giving lots of helpful advice and information, 
including all the legal stuff. You can let us 
know what you’re writing about, or, if you 
want to, you can just write the article and 
spring it on us when it’s done. [Note: We 
also have a need for people willing to make 
themselves available to write occasional 
product/book reviews.] If we publish your 
article, you'll be paid for it! 

Write to us, the editorial staff, at 
editorial@mactech.com (or one of the other 
addresses listed on page 2 of the magazine). 
Take the future of MacTech Magazine into 
your own hands! 


For Macintosh 
rogrammers & Developers 
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AppMaker 





Now building graphical 
interfaces for almost any 
framework you can imagine 
THE BAsIcs 


Flipping through one or two issues of 
MacTech will almost certainly reveal an 
advertisement for AppMaker from Bowers 
Development Corporation. Although this 
product was reviewed in MacTech/ 
MacTutor in 1989 (AppMaker vs. Prototyper, 
volume 5) we (the editors and I) felt that a 
revisit to this product was timely, given many 
changes in both the character of the product 
and corporate support policy. 

This application interface generator is 
a solid tool that delivers as promised, and is 
in the best Macintosh tradition of easy and 
intuitive use, cutting edge technology, and 
value-rich updates. Documentation has 
lagged behind product development, and 
this will be a source of frustration to some 
users, particularly those new to 
programming in general and the Macintosh 
in particular. Additionally, some users, 
again particularly those new _ to 
programming, may be surprised at what the 
program does not do. 

The concept behind AppMaker is 
quite simple. Using a drawing interface, 
the user designs windows, alerts, dialogs 
and menus selecting elements from a 
palette of controls, icons, pictures, etc. 


After the interface has been developed, the programmer 
generates source code and resources to implement the interface 
in the development system (language, IDE, plus framework) of 
the developer's choice. (I am going to use the term development 
system repeatedly throughout the article to refer to the 
combination of language, IDE, and framework.) We'll start our 
review with the contents of the distribution CD. 

AppMaker as currently shipped consists of a single CD and 
a manual. AppMaker is a product in evolution and the CD 
contains several versions of the application. I reviewed and 
used versions 1.5.9 and 2.0b6 (Mailing #5). I subsequently 
reviewed 2.0fcl (Mailing #6), primarily to update this article. 
(Mailing #7 will be out by the time this review appears in print.) 
The 1.5.x series of versions (more on why a series of versions 
below) is a stable, fully documented product that can be used to 
generate the resources and code to create applications in 
procedural C, procedural Pascal, Object Pascal TCL/MacApp 2.0, 
Object C TCL, C++ TCL 2.0 and MacApp 3.0/3.1. PowerPlant is 
not supported, nor is the most current version of MacApp. 
Fortran is available as an add-on. The 2.0fcl application is the 
only current version of AppMaker 2.0 and is the first non-beta 
version of the 2.0 series of applications. PowerPlant, TCL 2.0, 
MFC, OpenDoc, Java, and procedural C (straight C and Tools 
Plus) systems are all supported. No Pascal system is currently 
supported by version 2.0. (See below for more information on 
future supported versions.) 


Want to know what products are 
available for MacOS 


development? Check out 
Developer Depot™ 
<http://www.devdepot.com> 








Ed Ringel is the Contributing Editor for product reviews. In his spare time, he is a respiratory and critical care physician in 
Waterville, Maine. He can be reached at eringel@mint.net. 
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Wuy So MANY VERSIONS? 


Why this potentially confusing array of versions and 
supported development systems? 


Greate AppMaker 
Document 


| 


AppMaker Inputs 
Gode Generation 
Information 


Idea —* Ghoose System —* —® Generate Code 


Inthe 
dark? 


AppMaker 1.5.x 


Create AppMaker 


Iden —} 
Document 


—® Ghoose System —® Generate Code 


t 


AppMaker Inputs 
Code Generation 
Information 


AppMaker 2.0.x 


Shed some light 


on your network 
programming 


with EtherPeek: 


Figure 1. Schematic representation of language and system 
dependency among user documents, AppMaker, and code 
generation. 


The answer lies in the differences between the 1.5.x and 
2.0bx applications, which use fundamentally different document 
architectures and code generation schemes. When a new 
AppMaker project is undertaken, the user creates an AppMaker 
document; this document contains all the information about the 
interface to be generated. In the 1.5.x series of applications, the 


Why develop your networking applications in the dark? 


Use EtherPeek Lite, Ethernet protocol analysis software, 
to test and debug your software and hardware communica- 
tions in minutes instead of hours! 


user’s document is a series of resources understood by the 
development system; in 2.0fcl this document is development 
system independent and understood by AppMaker, which 
permits tremendous flexibility in reuse of an application’s or 
window’s layout. 

Code generation instructions are contained for the 1.5.x 
series of applications in a series of resource based documents and 
templates. This scheme has been completely revised in the 2.0 
application. More information is in the code generation templates 
and less information about code generation is in the user’s 
document. Also, the information now resides in the data, rather 
than resource fork of the template documents. The upshot of this 
is that in order to update code generation for the 1.5.x series 
applications, the application itself must be updated as well as the 
resource documents. 

Versions older than 1.5.9 are still maintained to provide 
support for older development systems, THINK C 5 and 6. The 2.0 
application only requires updating of the code generation scripts to 
handle changes in the various development systems. The 2.0 
application series is superior in terms of interface generation, and it 
would appear that Bowers Development has made a strategic 
decision to support the new format vigorously and pretty much to 
freeze, except for maintenance updates, the 1.5.x series of 
applications. Depending upon your development system, you will 
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e Check for protocol compliance. 


e Use hundreds of built-in 
decodes. (IP, IPv6, |GRP. 
Netware IPX/SPX, NetBEUI, 
NetBIOS, DECnet, AppleTalk) 


e Develop custom packet 
decoders. 


e Filter packets during or Bett wor 


after capture. 2 © ise dan 20.1 
e Test device reactions to 
specific packets. 


e Customize or alter 
packets for transmission. 


e Generate traffic to test 
varying loads. 


e Write your own plug-in modules. G 


Mention This Ad For Your Special 
US $399.00 EtherPeek Lite Price. 


CALL: 800/466-AGGP or (1)510/937-7900 
FAX: = (1)510/937-2479 

EMAIL: eplite-info@aggroup.com 
WWW: http://www.aggroup.com/eplite/ 
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Easy to learn 
Easy to use 
Runs quickly 
Needs little disk space 
Needs little memory 
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World-Class Controls 
for the Discerning Developer 

For all Macintoshes and system versions 
Eull color and multi-monitor support 
680x0, PowerMac and Fat/Safe format 


The finishing touch for a complete 3D look 


D text 
VY 7 buttons, 9 tabs and 11 sliders (flat/3 ; 
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only $89" V Customizable check boxes plus undefined state 
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Developer Kit mouse, smart scaling 







Free Evaluation Kit: 
Available on AOL, CIS, 
Internet and at our 
web site 


Tools Plus for 

_ Symantec (THINK) C/C++ $149 
THINK Pascal _ $149 
THINK C/C++ & Pascal $199 
CodeWarrier Bronze $199 
CodeWarrier Gold $249 
(We accept VISA and Amex. 
Add $10 for shipping.) 
*Call for Academic pricing 
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have the opportunity to use the older and/or newer systems. I think 
the 2.0 application is a better, more versatile product and will direct 
most of my comments to this version. 


CREATING A PROJECT 
When a new project is created, the first window that appears 
is a list of program elements, a kind of project window. 


Maina 
PDielngs 
bAlerts 
; Penge : - : 
> Applications — 


)Class Defs — 





Figure 2. Tools menu and project window for AppMaker 2.0. 


The majority of interface design work will take place within 
the menu, window, alert, and dialog subheadings, and this would 
be the first step in creating a new project — author the interface 
and the menus. While I don’t want to appear that I’m giving this 
aspect of the development short shrift, in point of fact the use of 
this aspect of the program is so incredibly easy that it is almost self 
explanatory. Using draw type tools, one simply places design 
elements on windows that will be treated like an alert, a dialog, or 
window. Every application is expected to have a main window, 
and this is created for you at the time you create the new project. 
The 2.0 application comes with a very wide array of really neat 
goodies — pretty buttons, sliders, spinners, edit fields, tab panels, 
pop-ups, etc. — that you can put in a window or dialog (or alert). It 
is very easy to create a handsome, up-to-date interface. 
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Figure 3. Test application’s main window. I built 
this in about 15 minutes. 


The menu construction kit is also fairly straightforward, and 
the “what you see is what you get” view is also interactive. Menus 
can contain submenus. The 1.5 and 2.0 versions have a relatively 
similar interface here, except that the project window in 2.0 is 
more comprehensive and windows for different kinds of 
program elements can be open at once. Menu construction is 
more versatile in 2.0, and there are fewer goodies in the design 
element palette in 1.5. We will revisit these partially finished 
windows and menus shortly when we add some functionality to 
the program under development. 

Real life use of the interface generator was fairly easy. When 
I used the 2.0 beta product, there were a variety of bugs. These 
problems were addressed in 2.0fcl and the prodcut appears to 
be stable. 

Things get even more interesting when we leave the basic 
design group. It is worth taking a detour from AppMaker for a 
bit and quickly review design structure for the major object 
oriented application frameworks supported. In all of these, 
objects communicate with each other through commands, which 
are simply numbers that are messaged from one object to 
another, either directly or by being passed up a command 
hierarchy. This is used in MacApp, TCL, and PowerPlant. 
AppMaker 2.0 has the ability to create, modify, and delete 
command constants in dialog windows and subsequently 
generate the appropriate headers. Critically, one can return to 
the partially constructed menus and windows and have button 
presses, menu selections, etc. issue commands; some of these 
commands can also be coded in AppMaker to open windows, 
open dialog windows, show alerts, etc. 
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Figure 4. The ability to create a custom command, not just a 
messaging number, is a tremendous strength of this product. 


It is possible to customize the header list in generated code, 
jump to a code fragment, or suppress method generation from 
this same window. The ability to fine tune the code generation is 
a major plus. 

It is possible to address many other aspects of application 
design in AppMaker. There is a window that allows construction 
of the application information. Document information can be 
defined. Adorners, views/panes, text traits and many other 
similar elements can be created and modified in this product. It 
is possible to form a wide variety of program elements as well; 
for example, creating classes from within AppMaker. AppMaker 
“understands” OOFile and NeoAccess, and it is possible to build 
database elements from within the program. Thus, I would 
envision an iterative process of program design, creating an 
interface, then creating commands and special classes, and then 
returning to the design interface, to attach commands and the 
like to the various design elements. This process might be 
repeated until you were comfortable with the interface and the 
functionality that could be created from AppMaker. The 
capabilities of the 2.0 version in this area far outstrip the 1.5.9 
version. 

“Power users” of AppMaker can use a companion program, 
AMCompiler, to customize AppMaker’s code generation at the 
level of the language script files. This tool is used by Bowers 
Development to create new language templates and to update 
existing language templates. 


GENERATING CODE 
Eventually, you would be ready to generate code. In the 
1.5.9 version, the development system is chosen at the time of 
the creation of the new AppMaker project document, in 2.0, 
the development system is chosen at the time of code 
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generation. As I indicated in the introduction, version 1.5.9 
supports TCL 1.1 (C and Pascal) and 2.0, MacApp through 3.1, 
and procedural C and Pascal. The code is sparsely commented, 
and occasionally it was difficult to decide where to place the 
functionality of the program. 

Basic Apple events are supported in version 1.5.9. There is 
relatively little in the code generated except for support of the 
interface. Procedural systems use a_ library of 
procedures/functions that implement the event loop and take 
care of basic interface support and housekeeping. The object 
oriented systems depend heavily (as they should) on the 
methods of the classes from which design objects are derived. 

Version 2.0 code generation is more robust, and the code is 
better commented. Despite this, it is not always absolutely 
obvious where to insert functions, or which functions must be 
supplied by the programmer. TCL 2.0 and PowerPlant are both 
supported, and since command elements can be customized, one 
can achieve sophisticated code generation. For TCL, AppMaker 
uses the two class, two file approach to code generation similar 
to Symantec’s Visual Architect. (Interestingly, I was told by Spec 
Bowers that AppMaker pioneered this strategy and it was 
subsequently adopted by VA.) This system isolates interface code 
that does not need further user intervention from the file that will 
be altered. For PowerPlant, the two class strategy is not used and 
functional code is inserted directly into a single file. Thus, beware 
if you regenerate your source files, even if your program is fully 
factored! AppMaker also generates the correct “special” resources 
(‘Ppob’ for PowerPlant, etc.) for the system in use. Procedural C 
helper and high level functions are used to simplify procedural 
code generation and do housekeeping, main event loop, etc. 
There are no bells and whistles here, but the code is 
straightforward and gets the job done according to Apple 
guidelines. 7 


NEW AND FOREIGN, TOO 

Version 2.0fcl offers support of new environments, and 
offers some options for cross platform development as well. It 
supports the creation of Java windows based on the Java AWT, 
but not freestanding Java apps. Non-embedding OpenDoc parts, 
based on the ODF system are supported. (See 
<http://members.aol.com/bowersdev> for more information on 
generating container parts as well as non-embedding parts.) 
Bowers Development indicates that OpenDoc support will be 
improved and broadened as a priority. Applications for Windows 
based on the Microsoft Foundation Classes can be created. To my 
knowledge, this is the only application that supports all these 
different development systems. The ability to create one 
AppMaker document and then generate five or six different kinds 
of code is extraordinarily appealing, particularly if you are 
working on a project that may ultimately be ported to Windows 
or be implemented in the future as an OpenDoc part. 

AppMaker plans expansion of its system base. I was told that 
ultimately all systems supported by 1.5.9 will be ported to 2.0. 
This would obviously include Pascal and MacApp, the two high 
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profile systems that are missing from current support. A Tools 
Plus 3.x generator is under active development, and a 
preliminary version makes its debut in 2.0fcl. (Given the quality 
of both products, this would be a powerful pair of procedural 
development tools.) Apparently, 2.0 system support is dictated 
largely by user feedback, so be assertive. 

Overall, the code for all the systems is quite solid. There is 
no showmanship, and no shortcuts, and perhaps that is the way 
it should be for such a product. In version 1.5.9, it is possible to 
suppress individual file regeneration when editing a project. This 
can be helpful if you have modified an AppMaker generated 
source file extensively. 


SOME LIMITATIONS, A FEW PROBLEMS 

It is important for potential purchasers to understand that 
AppMaker is an interface generator; it is not an application 
generator. It is easy to overlook that you still must add the 
function to your program, and hang up on creating the interface. 
In the procedural language arena, there are relatively few helper 
functions. The user must understand how to use the Toolbox to 
complete the application. When generating code for object 
oriented frameworks, a knowledge of both the Toolbox and the 
class library and framework of choice are essential. There are no 
high level functions to print a window or create a drawing 
environment or connect to a network. The novice programmer 
who has a great idea and expects to just put a few finishing 
touches on the resource file and fix a couple of details in the 
AppMaker generated code before shipping a finished application 
will be quickly deflated. On the other hand, if you understand 
the system you are using, or are committed to learning the 
system, you will get an enormous advantage in terms of time and 
basic solid code on which to build. 

Documentation for this product is less than optimal. For 
AppMaker 1.5, there is a spiral bound few hundred page book 
which is partially out of date, but it does get the sense of the 
product across. In particular, I was uncomfortable with how little 
information was provided in how to take the interface code 
skeleton and add functions. 

Documentation for version 2.0 is, for all intents and 
purposes, nonexistent. There are a few sparse text files which 
shed little light on how to use the product. Fortunately, 
AppMaker is so easy to use that one can get around this problem 
with some time and exploreation. Bowers Development 
recognizes this and promises to do better. 

Tutorials for both products are quite spartan as well. The 
learning curve of this product has a dogleg; while it is easy to use 
some of the product, e.g. plopping controls onto a window, 
getting the hang of creating commands or customizing the 
project window is not self-evident and takes a while longer. The 
lack of guidance for inserting your code into the skeleton is also 
very problematic for me. This is an almost perfect situation for 
creating an Apple Guide tutorial. 

Obviously, it is appropriate that the bulk of time and energy of 
Bowers Development goes towards improving the product, adding 
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new features, and squishing bugs. However, lack of finish is the 
major flaw of this product. The raw edges will present the greatest 
obstacle to the neophyte; I expect anyone who has programmed a 
Macintosh for a year or so will find things a bit sloppy, but will 
encounter no insurmountable problems. C++ programmers using a 
framework will probably have the fewest learning curve problems of 
all as the generated code will be very familiar to them. 


WHAT’S THE COMPETITION? (Or, WHY Buy APPMAKER?) 

The greatest advantage of AppMaker is the opportunity to 
avoid extensive reprogramming when ranging among development 
systems, particularly some of the newer environments such as C++, 
Java, and OpenDoc. There simply is no other product that can do 
this. Visual Architect of Symantec C++ is harder to use and doesn’t 
have as many goodies as AppMaker, and Constructor for 
PowerPlant doesn’t create code source files. On the other hand, 
they come with their respective development systems and impose 
no further cost. XVT DSC++ is a comprehensive, massive product 
that includes XVT-Architect, an interface and application generator. 
The package is quite expensive and has flaws, but offers the 
functionality of AppMaker and quite a bit more. Comparing the 
packages is a bit like comparing apples and oranges (or perhaps 
Apples and Windows), but I think AppMaker gives the buyer 
considerable value for money spent, and allows the construction of 
a more Mac-like program. (See my review of XVT in MacTech 
September 1996.) 

In the procedural language arena, AppMaker has serious 
competition, particularly in the C language area. Tools Plus 3.1 is a 
very good library and framework; version 3.0 was recently 
reviewed in MacTech. It does not have an interface builder, 
although one is apparently on the horizon. (A Tools Plus vs. 
AppMaker decision might no longer be an either-or decision with 
the arrival of an AppMaker generator file for this product.) VIP-C 
offers interface construction with code generation and a unique 
integrated environment including a wide variety of helper 
functions. (See my review March 1996 MacTech, also recent review 
of IDE’s in December 1996.) Both of these products do not have 
much ability to support multiple environments (although Tools 
Plus supports procedural Pascal). If you were certain that you 
would not be changing development systems in the near future, 
these products would warrant serious evaluation. 

One free product competes directly with AppMaker. This is 
Gooey 1.2, available wherever fine free software is found (I got 
mine on Apprentice 4) and is apparently the successor to 
Prototyper/Marksman. Not as nice, not as up to date, not nearly as 
many goodies, basically unsupported, but free. It supports C and 
C++ code, the latter being a home brew class library that is 
generated on the fly. It does not support the standard frameworks. 

AppMaker holds out the possibility of cross platform 
development in its support of the Microsoft Foundation Classes. 
AppMaker understands OOFILE and NeoAccess, and this, 
coupled with the ability to generate MFC code may dramatically 
shorten the development cycle for some programmers with cross 
platform projects. 
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Finally, the dependence of the product on established, 
supported frameworks is advantageous as well. Apple repeatedly 
suggests the use of supported frameworks as the best way of 
keeping up with technology changes, and AppMaker helps you 
do this. 


TECHNICAL CONSIDERATIONS, TECH SUPPORT, AND BOWERS 
DEVELOPMENT Corp. 

AppMaker comes on a CD. Bowers development is 
committed to three updates a year, wisely timed to come out a 
month afier the Symantec and Metrowerks updates, so that Spec 
and his gang can keep up. My understanding is that there have 
been steady, incremental improvements in technology for each 
update; this is substantiated in the release notes that I reviewed. 
There are goodies, demos, and user submissions on the CD as 
well. In corresponding with the company, it is clear that Bowers 
Development sees incremental improvement as critical to 
maintaining a client base, and improvements and additions will 
continue. On a personal note, I appreciate this and am grateful 
for a company whose updates.do more than just meet the 
compiler demands of CodeWarrior n+1; this is what being a Mac 
developer is all about. 

AppMaker 2.0 comes in both 68K and PPC flavors. The 2.0 
product is about 12-20 megs depending on what you choose to 
copy over to your hard drive from the CD, and the PPC interface 
tool and the compiler each would like a 2-3 meg piece of RAM, 
depending upon whether or not RAM Doubler/Virtual Memory 
are enabled. 

Technical support is offered by e-mail, fax and phone. The 
one question I did have was promptly (within 72 hours) and tersely 
answered. The CD comes with a no nonsense “treat us fairly and 
we'll treat you fairly” approach to tech support and licensing. The 
primary e-mail address is <bowersdev@aol.com>. There is a web site, 
<http://members.aol.com/bowersdev>, where updates and information 
can be found. Bug fixes and technology improvements that 
become available between CDs are posted here, and there are links 
to development system web sites. 


BoTToM LINE 

This is a good product. An experienced programmer can do 
a lot with it. A novice programmer can learn a lot using it and 
get a leg up quickly. Its support of multiple environments is 
unsurpassed. It needs a lot of work on documentation. It should 
be purchased with the understanding that it does not have a 
wide variety of non-interface support and helper functions. 
However, I think this is the interface application generator of 
choice for anyone working with C++ frameworks and/or 
OpenDoc. Programmers who plan to remain with procedural C 
or Pascal for the foreseeable future may want to comparison 
shop. The product is seeded on many distribution CD’s in demo 
form, but many of these are out-of-date. (Refer to the web site 
for the latest demos.) Test the features of this innovative product 
yourself and have some fun. 


APPMAKER EJ 
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By Michael Rutman, independant consultant 








Fixing your Computers the Manly Way 





Using testosterone to help 
fix computer problems 


ARE COMPUTER USERS REALLY GEEKS? 

For years I’ve had to put up with guys 
and their power tools looking down on me 
because my equipment is delicate 
electronics. It’s really not fair, especially 
since most powertools today have more 
computing power than my first computer. 
Still, they seem to feel that because their 
tools slice, dice, and otherwise mangle 
perfectly good pieces of wood, metal, etc. 
they are more manly than myself. 

Maybe that lovely tan a CRT creates 
isn’t as manly as the sawdust smell of a 
woodworker. However, there are many 
“manly” ways of fixing our computers that 
would put us right up there on the 
testosterone scale. 


VIOLENCE IS A LEGITIMATE TOOL FOR 
FIXING FAULTY COMPUTERS 

Many years ago Apple released the 
Imagewriter LQ. To this day, nobody 
seems to know why they released it, but 
they did. The LQ, that paragon of quality, 
had this endearing habit of having to be 
sent back to Apple every week or so to be 
fixed. Apple, of course, got right on the 
problem and hired a single summer intern 
to fix all of the LQ’s in the world. Yet, for 
some unknown reason the problems with 
the LQ persisted. 


A friend of mine that managed to purchase an LQ for 
himself, seemed to be getting a little frustrated with his LQ 
always being on the blink. Several “repairs” later, he decided 
that maybe fixing it himself would work better. Of course, if a 
summer intern fixing thousands of LQ’s at Apple couldn't get 
everything to work correctly, what would make my friend think 
he could do any better? After a bit of time, he gave up and 
realized that the LQ was just not going to work. 

A short time later, my friend was messing around with his 
45 caliber pistol. I know what you must be thinking, “what is 
he doing messing around with a loaded gun?” Well, remember, 
we are manly men, and we do stupid things. Fortunately, when 
the gun went off, it only hit the LQ. It went right through the 
back of his lovely printer, passing through the mechanism 
without touching a thing, and came out the top. 

Turning the printer on to check for damage, he 
attempted to print a page. You guessed it, everything worked 
great! It turned out that the back plate was rubbing agianst 
the mechanism, and blowing a hole in the back plate was all 
it needed. My friend tried to tell Apple, but apparently Apple 
frowns on summer interns firing guns on the Apple campus. 
Go figure. 


APPLE RECOMMENDS VIOLENCE 

Speaking of Apple products that require a little violence, 
Apple has in the past officially recommended beating on your 
computers. Those of us who have been around for a while can 
remember the sticky Quantum hard drives of the late 80s. 
Quantum had a rather large batch of hard drives with lubricant 
that was a little too viscious, and Apple had a bunch of 
computers that had too little umph in their power supply. The 
net result: if the Macintosh was cold, the hard drive couldn't 
start up. 

Apple’s official recommendation was, “Lightly bang the side 
of the computer to unstick the mechanism.” Personally, when 
I’m late on a project, “lightly” is a relative term. However, you 
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have to admit that banging on the side of electronic equipment to 
get it working is a manly thing to do. It was nice to see Apple ask 
us to be manly with our computers. 

This is not the first time that Apple recommended this kind 
of treatment for their computers. Those of you who go way 
back may remember the Apple III and Apple’s recommended 
boot process: turn on the computer, grab the left front corner, 
lift about 3 inches, and drop. Repeat as necessary. Now, some 
people say that the Apple III had loose components and this 
was the easiest way to reseat them. I disagree. Apple knew that 
a number of computer pecple were being looked at like geeks, 
and they wanted to help us. After all, what's more manly than 
dropping a several thousand dollar computer in order to fix it? 
You could drop it, then look at the neandrethals with their 
power tools, guns and other manly things and say, “It just takes 
a certain knack.” 


POWER TOOLS AND THE COMPUTER 

I have personally used a table saw to fix a powerbook. 
One of my friends managed to replace every part of his duo 230 
except the back plate of the monitor. Unfortunately, he 
managed to break the plastic nut off the back plate and the 
screen would not work. Normally, I would recommend he get a 
new back plate, but his back plate had lots of stickers on it, and 
we all know how important those are. 

Never one to be daunted, I realized we could fix this with 
a liberal application of every power tool I could get my hands 
on. For those of you who watch “New Yankee Workshop,” you 
know that one should never do a job with a hand tool when 6 
power tools will work. Taking the computer into the 
workshop, I realized that we could just glue a nut onto the 
computer, but that wouldn’t use any power tools. So, | 
convinced my friend that it needed a brace to hold the nut, or 
the nut might slip while the glue dried. 

Using my table saw, we were able to rip a small enough 
piece of wood to be thin enough to fit into the case. We were 
able to use the drill press to make a hole for the nut, but I had 
to use a hand saw to cut the wood brace down to size. I did 
get to use the miter saw to make a brace for the clamps, but 
my friend stopped me from sanding the brace to give it a 
smooth polish. Something about being on the inside where 
nobody was going to see it. 

A ton of epoxy later, we had a chance to drink beer while 
waiting for the epoxy to dry. After all, when you are doing 
manly things with power tools, you have to do something 
stupid, and what’s more stupid than getting drunk when the 
potential for more power tool use is there? Unfortunately, the 
glue held and the only other tool we got to use was a 
screwdriver. 


OTHER CASES, OTHER MANLINESS 
After a quick query for other manly fixes, I've come up 
with a few more stories. I don't have first hand knowledge of 
how true these are, but what kind of manly man would ever 
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exagerate his manliness? So, with that in mind, I bring them for 
you to judge on your own. 

One friend tried to slip in the time he fixed his stereo with 
his Ruger Mini-14 rifle. At first I was excited, especially when he 
told me that before shooting it, the stereo’s left speaker was 
reduced to noisy static and the phonograph arm jammed, but 
after shooting it, both speakers were at the same quality and the 
arm swung freely. Unfortunately, after a little more proding, he 
admitted that the quality of sound was closer to static than 
music, and the arm swiging freely included swinging in rooms 
the phonograph was not in. So, I must say a 10 for manliness, 
but not a recommended procedure. 

Another story I heard uses a refrigerator to fix the 
computer. This brave computer user has found that cooling 
the floppies in the refrigerator makes them easier to read. At 
first, I was skeptical. After all, who would have thought to try 
it in the first place? Then my wife reminded me that she has 
pulled the remote control out of the refrigerator many times 
after I’ve gone for something to drink. So, 1 could see 
someone leaving their floppies in the refrigerator when going 
for a cola. After that, I can see why the cold floppies always 
work, while the warmer ones are unreliable. 


GEEKHOOD, OR MANLY MEN IN DISGUISE? 

So, the next time some manly man, who just happens to 
know how to fix every appliance in your house with chewing 
gum (as well as build the house for you with a nail file), 
disdains typing at a computer, remember, we too can be 
manly men. If we try very hard, I’m sure we can even hurt 
ourselves doing it. 


We hope by this point you realize this article was 
presented in jest. This 1s, after all, the April issue (that ts, 
April Fools Day is in April). We apologize if the article 
inadvertently offended you. If you are still bothered by it, 
drop us a note and we'll see what we can do to ensure you 
don't receive such articles in the future. If all else fails, 
take scissors to the articles you don’t like and then you 
won't have them! ;-) WH 
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By Martin Frické, Tucson , Arizona 
Transmuting Text 


Seemlessly exchanging 
text labels and 
editable text objects 


One common problem with diagrams 
and intricate dialogs is that there are often 
many separate editable text items that have 
a small storage overhead relative to their 
own data content. For example, the user 
may want to label the four corners of a 
square; each label editable and most labels, 
but perhaps not all, consist of only a few 
characters in one style. A problem arises in 
that the data-structures to support style and 
styled-editing are reasonably substantial. 

For example, the Mac TERec is 96 
bytes large compared with one byte to 
represent the single character that is 
actually on one of the corners of the drawn 
square. If a single body of text is large, the 
supporting style data-structures are 
insignificant, but with a multiplicity of small 
labels in a diagram, the content can easily 
get swamped by the support — as much as 
200k can be used for one page of svmbols. 
On the other hand, if the program 
considers a label to be just a string of 
characters, the label can be stored frugally 
and drawn easily, but it would not be as 
easily editable. 

Many commercial programs do not 
fare terribly well with this problem (no 
names, no pack drill). There are a few 
standard techniques. Several painting 





programs use once-only editing. A new label is editable, but the 
moment that new label is de-activated, the text in it is converted 
into a bit-map and merged into the background. Therefore, this 
label cannot be recovered back into text and edited again. 
Other programs use a string to represent an individual small 
text item, then they float editable text over the top of the single 
active item. This can work, but conceptually it is pretty 
unattractive and often aligning the floater and the background 
string can be awkward. 


THE TRANSMUTING APPROACH 

We are obviously going to use objects as far as we can. What 
is required most often are string objects for the individual small 
text items. However, at most there will be one editable text, so 
this will be an editable text object, and any of the string objects 
can assume this role. What is needed are transmuting objects. 

There are to be many string objects, and at most, one of 
these may be transmuted back and forth to an editable text 
object as required. The time to transmute is clearly on activation 
and de-activation, since there is only one editable text at a time 
(the active one). The only other property required of the objects 
is the ability to draw themselves, especially when inactive, as 
might occur during an update. Care must be taken over the 
drawing, because the pen may have to produce and match 
exactly the same result when drawing either version of a 
transmuted object. 

Transmutation here amounts to replacing one object with 
another — perhaps creating one and deleting the other. You 
would not want to do this with an object that is referred to by 
other parts of the program, for that might leave dangling 
references. Caution suggests hiding the transmuted object 
within a public object — all public references will then be to 
the public object. 

It may be that the editing by the user makes what formerly 
was a simple label into complex styled text (maybe akin to the 
opening page of a King James Bible), in which case, the text is 
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not transmuted back to a string on de-activation. Another 
decision concerns a default style for the labels — each label can 
have its own, or there could be a global style. The choice is left to 


the designing programmer. 


A CODE EXAMPLE 


The code uses Marco Piovanelli’s WASTE styled-text engine 
<http://cirrus.sprl.umich.edu/waste/>. In a perfect world the code 


looks something like the following. 


class TText : public CAbstractText 
// Abstract text supplies all the other methods 
{ 


private: 
TPrivateText *fInternalText; 
public: 
void ActivateText (Boolean OnOff) ; 
void Compact (); 
void UnCompact () ; 


virtual void Update(RgnHandle updateRgn) ; 
} 


void TText::ActivateText (Boolean On0ff) 

{ 

if (OnOff) 
{ 
UnCompact () ; // transmutes from a string, if needed 
FocusToDraw(); 
fInternalText->»Activate (true) ; 
} 


else 
{ 
FocusToDraw(); 
fInternalText->»Activate(false) ; 
Compact () ; // attempts to transmute into a string 


} 


void TText::Compact () 
{ 
Handle itsText; 
TInternalText *newText; 
Point itsPenStart; 


if (fInternalText->CanCompact () ) 
{ 
itsText= fInternalText->GetText () ; 
stsPenStart= fInternalText->»GetPenStart(); 
newlext= new TString(itsText,itsPenStart) ; 
delete fInternalText; 
fInternalText=newTlext ; 
} 

} 


void TText::UnCompact () 
{ 
Handle itsText; 
TInternalText *newText; 


if (fInternalText->CanExpand () ) 

{ 
itsText= fInternalText->GetText (); 
newText= new TStyledText (itsText) ; 
delete fInternalText; 
fInternalText=newText ; 
} 

} 


void TText::Update(RgnHandle updateRgn) 
{ 


if (RectInRgn(&fBoundingBox, updateRgn) ) 
{ 
FocusToDraw() ; 
Frame (); 
fInternalText->Update(updateRgn) ; 
} 
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class TInternalText // important fields and methods only 


{ 

virtual void ActivateText (Boolean OnOff) {;}; 
virtual Boolean CanCompact() (return false}; 
virtual Boolean CanExpand() {return false}; 
virtual Handle GetText (): 

virtual Point GetPenStart() {return PointOf(0,0)}; 
virtual void SetPenStart (Point aStart) {3}; 
virtual void Update (RgnHandle updateRgn) ; 

} 


class TString: public TInternalText 


// important fields and methods only 
{ 

Handle fText; 

Point fPenStart; 


Boolean CanExpand() {return true}; 

Handle GetText() {return fText]; 

void SetPenStart (Point aStart) (fPenStart=aStart} ; 
void Update (RgnHandle updateRgn) ; 


} 


class TStyledText : public TInternalText 


// important fields and methods only 
{ 


void ActivateText (Boolean OnOff); 
Boolean CanCompact (); 

virtual Point GetPenStart() {return PointOf(0,0)1]; 
Handle GetText () ; 

void Update(RgnHandle updateRgn) ; 


void TString::Update(RgnHandle updateRgn) 
{ 
MoveTo(fPenStart.h,fPenStart.v) ; 
HLock(fText) ; 
DrawText( *fText, 0, GetHandleSize (fText) ); // Toolbox Routine 
HUnlock( fText ); 
} 


Boolean TStyledText: :CanCompact () 
{ 
long oldStart,oldEnd, length; 
long kMaxString=999; 
SignedByte alignment; 
Boolean canDo=false; 


length= WEGetTextLength (fMacWE) ; 

WEGetSelection(&oldStart, &oldEnd, fMacWE) ; 

if ((oldEnd-oldStart) <kMaxString) // not too long 
a cue chenton tial neue een 


mode = doFont + doFace + doSize t+ aocolor: 


alignment=WEGetAlignment (fMacWE) ; 


// one style 
if ((WEContinuousStyle(&mode, &aStyle, fMacWE)) && 
// one line 
(WEOffsetToLine(kMaxString, fMacWE)==0) && 
// no fancy alignment 


((alignment== weFlushLeft) 
\ | (alignment== weFlushDefault) ) 
) 


canDo=true; 


WESetSelection(oldStart,oldEnd, fMacWE) ; 
} 
else 
return canDo 


} 
Point TStyledText: :GetPenStart () 


{ 
Point penStart; 
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short lineAscent,lineDescent; 
LongRect destRect; 


WEGetDestRect (&destRect, fMacWE) ; 
penStart.h=destRect.left; 

_WECalcHeights(0, 1, &lineAscent, &lineDescent, fMacWE) ; 
penStart.v= destRect.toptlineAscent; 


return 
penStart 


void TStyledText::Update(RgnHandle updateRgn) 
{ 
WEUpdate(updateRgn, fMacWE) ; // passed to the styled text engine 
} 


Unfortunately, the real world forced some modifications to 
this code. The Macintosh styled-text engine and the WASTE 
styled-text engine were not originally written as objects. They 
could have been given a wrapper to make them into objects, but 
normally they are used as Handles to records. This is not much 
different from Handles to objects. In the practical implementation 
the internal private text objects are not used. Instead, the 
fInternalText field is either just a Handle directly to a WASTE 
record or a handle to the raw text. Strictly speaking, the text 
transmutes a Handle based internal data structure rather than a 
Handle based internal object. However, it does work perfectly to 
produce results like the following sequence. 


Untitled-1 


This is text 


a 


This is a string 


Untitled-1 





Figure 2. Some of the text is obscured (to demonstrate 
that the drawing routines mesh properly). 
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At this point, both labels are strings. The first several letters 
of the top label have been drawn by the text drawing routine. 





This is text 


This is a string 





Figure 3. Text is redrawn by string drawinf routine. 


If we move the the obscuring window to one side (Figure 
3) we notice that the half ‘e’ and the ‘xt’ in the top label are 
drawn perfectly by the string drawing routine and the mesh of 
half-a-text-draw and half-a-string-draw is exact. 

Next, the document and the top label is activated and the 
‘xt’ changed to Chicago 18. This makes the label styled text, 
which will not transmute. The text is obscured again. Remove 
the obscuring window, and there is a perfect redraw of the 
top label (as styled text) and the bottom label (as a string). 
(See Figure 4.) 


Untitled-1 





This is teHt 


This is a string 





Figure 4. Obscured styled-text redrawn. 


Similarly, the document and the bottom label can be 
activated, the bottom label made into styled text, and the 
obscuring sequence repeated. 

A sceptic might say that the drawing routines here and the 
end results are visually indistinguishable from one another — 
how do we know that all this transmutation is actually 
happening? To see that the code was working properly, a 
single debugging SysBeep(5) is enclosed with the string 
drawing routine, and a double SysBeep(5) with the text 
drawing routine — you can hear the Updates. 


Visit MacTech Magazine’s Web site! 


http://www.mactech.com 
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By Matthew Hopkins 


In this month’s column, we 
are focusing on customer 
issues pertaining to our 
C++ and Java development 
environments, including 
the newly released Visual 
Café. Let’s warm up with a 
question regarding Visual 
Page, a dynamic web- 


authoring utility 





Q: In Visual Page, how do you tell 
what size a document is before you 
save it? 


A: By selecting Download Statistics... 
from the Edit menu, you can see a 
dialog box which not only tells you 
the total document size, but also 
tells you how long (on the average) 
it will take to download your page, 
depending upon the speed of your 
modem. 


Q: I am using Visual Café, and I am 
having a problem getting the 
GridLayout to work properly. For 
instance, when I set the number of 
columns to 3 in the Property 
Manager, the applet doesn’t 
respond at all visually. What's 
going on here? 
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A: Visual Café behaves in this manner because of how 


GridLayout is implemented in Java. When the rows and 
columns are both defined to anything other than 0, the Layout 
Manager will ignore the number of columns you have 
specified and calculate them based upon the number of rows 
and the number of elements. If you are interested in having 
the Layout Manager organize your elements according to a 
certain number of columns, set the number of rows to 0 
(meaning “any”), and the Layout Manager will make the 
number of rows dependent upon the number of columns. 


: | am getting an error of type -43 when running my Java 


application in Symantec Café. How do I correct this? 


: In an application, the main function needs to be static, and the 


main class needs to be set in the Project Options window. 


: Iam running the following program in Symantec Café and it 


does nothing but hang. Could you tell me why? 


class PrintThread implements Runnable { 
Dering Str; 


public PrintThread (String str) | 
this.str = Str; 


public void run() [{ 
for (i) 
System.out.print(str) ; 


class ConcurrencyTest [ 
public static void main(String argv[]) { 
new Thread(new PrintThread(“A”)).start() ; 
new Thread(new PrintThread(“B”)).start(); 


} 


: This does not actually cause a freeze. It just appears that way 


because the System.out.print never receives a “” character, so 
it never shows you what’s going on; it adds characters to the 
print stream indefinitely. To achieve the results you intended 
(mainly, seeing A and B printed forever), either call 
PrintThread with “A” and “B”, or change the line reading 
System.out.print(str) to System.out.println(str). 
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Q: 


= 


Which folder do you put packages into in Symantec Café for 
the Mac? 


You have two options: 

Place any additional class packages into the {java libraries} 
folder. 

Place them in whatever folder you like as long as you open the 
Preferences:Paths window and add the search path to the 
upper window so that Café will know to search that folder. 


I am developing an application in Café that includes HTML 
text and embedded Applets. Some of the applets need to 
read local files whose names are supplied by the user, but 
the applet security rules prevent applets from reading local 
files. Is there a standard way of reading user-OK’ed local 
files that I am missing? 


The names of the files have to be “fully qualified” (Ce. 
volume/folder/file), and there can be no non-standard 
characters anywhere in the path (like f after folder names.) 
You can use something like this 


FileDialog file_dialog open; 
file_dialog open = new FileDialog(this, “Open A File”, 
FileDialog.LOAD) ; 


public void loadFile() 
file_dialog_ open. pack() 
file_dialog_open.show(); 
if (file_dialog_open.getFile() != null) { 
currentFolder = file_dialog_open.getDirectory(); 
selectedFile = new 
String (file_dialog open.getFile()); 
fullPath = currentFolder + “/” + selectedFile; 
} 


This lets the user select a file and then pass the fully 
qualified path name for the file to the method that actually 
accesses the data. 


Is there a simple way to use ImageMaps for applets in Java? I 
need to write an applet that loads a graphic file at the proper 
coordinates when the mouse is moved over a certain location. 


The key to this problem is the Component action method 
mouseEnter(). This works for all components, including 
buttons, windows, etc. In order to implement ImageMaps, | 
find the canvas component to work the best. being 
invisible. Here is a small snippet of code written in Visual 
Café that illustrates this 


import java.awt.*; 
import java.applet.*; 


public class Appletl extends Applet { 
public void init() { 
super.init(); 
setLayout (null) ; 
addNotify() ; 
resize(426,266) ; 
theMap = new ImageMap(“myMap”, 50, 50, 
getGraphics()); 
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theMap. reshape (60, 31,186,150) ; 
add(theMap) ; 


public boolean handleEvent(Event event) { 
return super.handleEvent (event) ; 
} 
ImageMap theMap; 
} 


class ImageMap extends Canvas { 
boolean on; 
String label; 
Graphics g; 


ImageMap(String label, int sizex, int sizey, 
Graphics g) { 
this.label=label; 
this. g=g; 
resize(sizex, sizey); 


public void paint(Graphics g) { 
update(g); 
} 


public void update(Graphics g) { 
if(on) { 
this.g.drawString(“Hello, World!”, 


public boolean mouseEnter(Event evt, int x, int y) 


on=true; 
repaint(); 
return true; 


Here, the text Hello, World! has been substituted for the 
image that should be displayed. In case you wish to remove 
the image when the mouse is removed from the area, use the 
method mouseExit() in the same way. 


I am using a HashTable to keep track of a number of Button 
objects in Symantec Café, but every time I click on the 
button and look up the corresponding HashTable entry, it 
returns null. 

import java.applet.*; 


import java.awt.*; 
import java.util.*; 


public class HashTblTest extends Applet { 
Hashtable ht = new Hashtable(); 
Button[] b = new Button([3]; 


public void init() 


MN oO 


for (int 2.= 044% 3¢ae) 1 
b[i] = new Button(“Button “ + i); 
add(b[il]); 
ht.put(b[i], new Integer(i)); 


} 

public boolean action(Event e, Object o) { 
System.out.printlin(ht.get(o)); 
return false; 


What am I doing wrong? 
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A: The problem here is that the Button action method counter- 
intuitively provides as its Object parameter a STRING which is 
the button’s name, not the button object itself. You have 
entered the buttons themselves into the HashTable, but the 
action method is looking up a string, not a button in your 
table. The best way to work around this is to change your 
action code to read: System.out.println(ht.get(e.target)); This 
will achieve your desired results. 


Q: I have written a program in the Think Project Manager 7.0.5 
that runs in the debugger, but when I try to run it in the 
Finder or without the debugger, the main window does not 
even come up. What do I need to do to get it to work? 


A: This usually indicates a failure to initialize the Macintosh 
toolbox. Your code seems to work in the debugger because 
the debugger initializes the toolbox for you. 


Q: I have written a program that uses two-dimensional and 
three-dimensional arrays. It seems to look fine but I keep 
getting link errors. What can I do to fix this problem? 


A: It sounds like you are putting some huge arrays on the stack! 
Space is allocated for these arrays prior to run-time, and if 
your arrays are large enough, you could be causing a stack 
overflow that is posing some problems for the linker. There 
is an excellent example on how to put these arrays on the 
heap (allocating them at run time) in the Think Reference 
under Arrays Bigger than 32k. 


Special thanks to Mark Baldwin, Ted Flug, Richard Hill, Steve 
Howard, Scott Morrison, Kevin Kenan, and Kevin Quah. 
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Finish your installer 
in record time 
with Draginstall. 


You've run a long race. 
You're almost done with your product. 
your p 


Now that it’s time to build your installer, 
don’t let complex licensing arrangements 
and complicated tools trip you up. 





Download a demo of Draglnstall 
from http://www.sauers.com/draginstall 


Build your installer 
in a single step with DragInstall’s QuickScript feature 


Register Draglnstall 
with a single phone call to 1-800-890-9880 


And cross the finish line 
total time: 1 hour, total cost: $300 


= 
oN 
eH 





For more information: 


Ray Savers Associates, 1187 Main Avenue, Suite 1B, Clifton, NJ 07011 USA 
voice: 201.478.1970, fax: 201.478.1513, email: info@sauers.com 
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/ PROGRAMMER’S 


CHALLENGE 


By Bob Boonstra, Westford, MA 





PROJECTION 


For the Challenge this month, we return to the topic of computer void InitProjection ( 


es My3DPoint *viewPoint, /* viewpoint from which to project */ 
graphics — you'll be solving a simplified rendering p roblem. Your My3DPoint *illumPoint, /* viewpoint from which to draw shadow */ 
Challenge is to create the image formed by a set of polygons on a void “storage,  /* auxiliary storage preallocated for your use */ 
long storageSize /*number of bytes of storage */ 


specified projection plane, as viewed from a specific viewpoint, 
and as illuminated from a point light source. You will need to 


perform hidden surface elimination, create shadows caused by the eS ice 


GWorldPtr offScreen, /* GWorld to draw projection */ 

light source, and project the image as it would be seen by MyPolygon thePolys[], /* polygons to project */ 
+i ; long numPolys, /* number of polygons to project */ 

someone at the viewpoint. You will be performing multiple My3DPoint *viewPoint, /* viewpoint from which to project */ 
projections from a given viewpoint, so this Challenge includes an My3DPoint *illumPoint, /* illumination point from which to draw 
tigalione ; ; shadow */ 
initialization routine as well as a calculation routine, both of which aoa seuorace, Pailin sioeue melneeed fer youu” 
are included for timing purposes in determining the winner. long storageSize /* number of bytes of storage */ 


The prototype for the code you should write is: 


ffdefine kMAXPOINTS 10 ae . . . . . 
Your InitProjection routine will be provided with a pointer to 


eee Se eee auxiliary storage (storageSize bytes, at least 1MB) preallocated for 


/* point in z==0 plane */ 


float x2D; /* x coordinate */ es 
float y2D; /* y coordinate */ your use, along with the viewPoint from which projections are to 
} My2DPoint; 


be made and the illumPoint location of an illumination source from 


typedef struct My3DPoint { which shadows are to be created. InitProjection may perform any 


float x3D; /* x coordinate */ ' . oe 

Ficus Wb: /*y coordinate */ calculations that may be useful for multiple CalcProjection calls that 

float z3D; /* z coordinate */ follow. CalcProjection will be provided the same parameters given 
} My3DPoint; 


to InitProjection, along with the number (numPolys) and location of 
the polygons to be projected, and the offScreen GWorld in which 
the projection is to be drawn. CalcProjection should calculate the 
way thePolys would look from viewPoint, projected onto a 
projection plane normal to the viewPoint vector and passing 
through the origin. Hidden surface elimination must be performed 
so that obscured polygons or parts of polygons are not seen. The 
image of the projection is to be rendered in the GWorld pointed 
to by offScreen, with the projection plane mapped to the z== 


typedef struct My3DDirection { 
float thetaXx; 
float thetaY; 
float thetaZ; 

} My3DDirection; 


/* angle in radians */ 
/* angle in radians */ 
/* angle in radians */ 


typedef struct MyPlane { 
My3DDirection planeNormal; 
My3DPoint 
} MyPlane; 


/* normal vector to plane */ 
planeOrigin; /* origin of plane in 3D space */ 


typedef struct MyPolygon { 


long numPoints; /* number of points in polygon */ plane in the GWorld. Polygons must be rendered in the 
My2DPoint thePoint[kMAXPOINTS]; /* polygon in z==0 plane */ 
MyPlane polyPlane; /* rotate/translate z==0 plane to this plane */ 
RGBColor polyColor /* the color to draw this polygon */ 
} MyPolygon; 


THE RULES 


Here’s how it works: each month we present a new programming 
challenge. First, write some code that solves the challenge. Second, 
optimize your code (a lot). Then, submit your solution to MacTech 
Magazine. We choose a winner based on code correctness, speed, size, and 
elegance (in that order of importance) as well as the submission date. In 
the event of multiple equally desirable solutions, we'll choose one winner 
(with honorable mention, but no prize, given to the runner up). The prize 
for each month’s best solution is a $100 credit for Developer Depot™. 

Unless stated otherwise in the problem statement, the following rules apply: 
All solutions must be in ANSI compatible C or C++, or in Pascal. We disqualify 
entries with any assembly in them (except for challenges specifically stating 
otherwise.) You may call any Macintosh Toolbox routine (e.g., it doesn’t matter if 
you use NewPtr instead of malloc). We compile all entries into native PowerPC 
code with compiler options set to enable all available speed optimizations. The 
development environment to be used for selecting the winner will be stated in the 
problem. Limit your code to 60 characters per line or compress and binhex 


the solution; this helps with e-mail gateways and page layout. 

We publish the solution and winners for each month’s Programmer's 
Challenge three months later. All submissions must be received by the Ist day 
of the month printed on the front cover of this issue. 

You can get a head start on the Challenge by reading the Programmer’s 
Challenge mailing list. It will be posted to the list on or before the 12th of the 
preceding month. To join, send an email to listserv@listmail.xplain.com with 
the subject “subscribe challenge-A”. 

Mark solutions “Attn: Programmer’s Challenge Solution” and send it by 
e-mail to one of the Programmer’s Challenge addresses in the “How to 
Communicate With Us” section on page 2 of this issue. Include the solution, 
all related files, and your contact info. 

MacTech Magazine reserves the right to publish any solution entered 
in the Programmer’s Challenge. Authors grant MacTech Magazine the 
exclusive right to publish entries without limitation upon submission of 
each entry. Authors retain copyrights for the code. 
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Announcing 


VICR@QGUARD~ 


_ Why so many developers are switching to 
MicroGuard copy protection 


™ 





® MicroGuard is committed to uncompromising = @ MicroGuard has now surpassed its own 


technological superiority technological lead, actually improving on the best 
"Technology at its peak" is our commitment to you. That is why we have MicroGuard Plus is everything MicroGuard is, plus 40-bit encryption, two 
brought you MicroGuard Plus™. And, MicroGuard Plus is 100% additional passwords, 64-Bit Array, 32-byte public area, 45% size reduction, 
backwards compatible with MicroGuard. This means MicroGuard enhanced counter and more. In addition, MicroGuard Plus offers two new 

and MicroGuard Plus can be used interchangeably. utilities: QuickGuard™ and EasyGuard™ allow you to protect your 


applications without touching your 
source code. The only feature that 
is not plus is the price. :-) 


Just as we promised! 


@ MicroGuard offers you the 





most sophisticated network MicroGuard is the best 
protection selling Macintosh key in 
Our network protection, MicroGuard Net™ , the world 


is SO superior, we had to hire an Apple network 


engineer to execute our specifications. MicroGuard sells more Macintosh 


copy-protection keys than anyone else 
in the world! 


@ MicroGuard is the only key 





developed by Mac ® MicroGuard delivers 
developers, and is the first oe : — developer support 
and only 100% ADB savy key | within 24 hours 

We have been developing Mac applications as a seed development house We will answer any inquiry you have within 24-hours. We also have a fully loaded 
since 1984. We are not a PC protection company that has come to you AppleLink bulletin board which contains all our libraries, tech notes, Q&A and 
with a Mac product. MicroGuard is fully ADB savvy and offers extended nearly everything you'll ever need! 


addressing. Unlike other protection devices, MicroGuard never clashes 
with other keys. Only MicroGuard offers this level of sophistication. 






(actual size) 






For more information and to order a Developer's Kit or to receive a free CD ROM about MicroGuard, 
please contact us at: 





MicroGuard USA: Tel: (303) 320-1628 © Fax: (303) 320-1599 — * AppleLink: M(GUARD : 
International: Tel: (972) 3 558-2345 © Fax: (972) 3 558-2344 © AppleLink: MICROGUARD Mac OS 





Pirate Busters 


appropriate polyColor, subject to the limitations of the GWorld. 
Polygons are the same color on both sides. Parts of the projection 
plane not filled by projections of polygons should be black. 

In addition to projecting the polygon image as seen from 
viewPoint, you must also project the shadow of thePolys created 
by an illumination source at illumPoint, onto the projection plane 
and onto the image of other polygons, as seen from viewPoint. 
Shadows should be rendered in the color of the surface in 
shadow, using a 50% gray pattern. All polygons have a flat matte 
surface, creating no specular reflections of the illumination 
source. The illumPoint will be on the same side of the projection 
plane as the viewPoint. 

Polygons are specified in 2-dimensional coordinates in the Z==0 
plane, to ensure that all points are coplanar, along with a 
planeNormal vector that specifies the orientation of the polygon 
plane and a planeOrigin that specifies the plane origin. The last 
vertex of a polygon is connected to the first vertex to close the 
polygon (i.e., a square would have four vertices, not a fifth that is the 
same as the first.) The true polygon coordinates to be projected are 
calculated by first rotating counterclockwise about the positive z axis 
by thetaZ (ie., the positive x axis rotated 90 degrees maps to the 
positive y axis), then counterclockwise about the positive x axis by 
thetaX (i.e., positive y rotates to positive z), then counterclockwise 
about the positive y axis by thetaY (i.e., positive z rotates to positive 
x), and finally by translating the origin to the planeOrigin point. In 
matrix form, the transformation is: 























Xx x3D x2D 
Y | = | y3D | + Ry Rx Rz | y2D |, where 
i Z3D 0 
cos(thetaZ) -sin(thetaZ) 0 
Rz = | sin(thetaZ) cos(thetaZ) 0 
0 0 1 
1 0 0 
Rx = 0 cos(thetaX) -sin(thetaX) 
0 sin(thetaX) cos(thetaX) | 
cos(thetaY) 0 sin(thetaY) | 
Ry = 0 ] 0 
-sin(thetaY) 0 cos(thetaY) 





The offScreen GWorld will have a pixelDepth of 32. The 
viewPoint and illumPoint will have z coordinates greater than zero, 
but thePolys may have coordinates with arbitrary values (after 
rotating and translating the polyPlane). The projection plane is 
Opaque, meaning that any part of a polygon behind the projection 
plane is invisible, creating no projection and no shadow. 

On average, CalcProjection will be called approximately 10 
times with the same viewpoint and illumPoint, but different 
polygons, for each call to InitProjection. The code producing the 
fastest projection, including both the InitProjection and 


VISIBLE WINDOW 
TOTAL Bubble Xchg Quick 
Charles Higgins 506.6 1.0 54.6 0.9 
Ken Slezak 64.0 0.8 59.7 3.4 
Optimized 33.5 0.7 37.0 0.8 
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CalcProjection times, will be the winner. 

This will be a native PowerPC Challenge, using the latest 
CodeWarrior environment. Solutions may be coded in C, C++, 
or Pascal. 


THREE MonTHs AGO WINNER 

Perhaps it was the short amount of time to work with the 
BeOS CD-ROM bundled in the January issue of the magazine, or 
the fact that the BeOS required a 604 PowerMac, or some minor 
installation anomalies with the BeOS, or to migration of interest 
to a prospective NeXT-OS — whatever the reason, only two 
people entered the BeSort Challenge. Congratulations to Charles 
Higgins for submitting the fastest solution to the BeSort 
Challenge. The problem itself was fairly simple: write a 
SortWindow class that would sort a list of character strings by one 
of three methods, two specified by the problem statement and 
one of your own choosing. 

Both Charles and the second contestant, Kenneth Slezak, 
implemented the required bubble sort and exchange sort methods, 
and both used the quicksort algorithm for the third method. The 
main difference in efficiency was in the technique used to swap list 
elements. Charles exchanged the pointers in the list and invalidated 
the list view to cause the list to be redrawn. Kenneth deleted the 
items to be exchanged from the list and added the items back into 
the list in the reverse order. On my 8500, the former was faster by 
10+%. Interestingly enough, when run on a BeBox, the latter was 
~5% faster. Since the problem statement called for evaluation on the 
Macintosh, Charles’ solution is the winner. 

One other interesting observation — in the winning 
solution, execution time was dominated by display time. I 
verified this by repeating the timing tests with the windows 
hidden. In the winning solution, this reduced execution time by 
almost 80%. In Ken Slezak’s solution, execution time was 
dominated by the list additions/deletions used to swap list 
elements, so the difference in results is much smaller. 

A straightforward optimization to the winning solution 
improved execution time significantly. Instead of invalidating the 
ListView each time two elements were exchanged, one need only 
invalidate the rectangles for the two items being exchanged. This 
change reduced execution time by some 30% when the windows 
were visible. (It actually hurt performance when the windows 
were not visible.) 

The table below provides the execution times and 
code sizes for each two solutions submitted, plus the 
optimized version of the winning solution. It shows the 
time, in seconds, required to sort a list of 500 strings by 
each of the three sort methods, with either visible 
windows or invisible windows. 


INVISIBLE WINDOW 
TOTAL Bubble Xchg Quick Code 
12.0 0.4 11.3 0.4 1472 
59.8 0.7 55.9 3.2 1620 
93.9 05 42/ 07 1536 
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ind our skills are pretty sharp, too. 

Ve can trim your content, hone your design, and 

nplement a Web site that’s...well...a cut above the rest. 
With today’s chopped budgets and pared-down schedules, you 

eed JointSolutions Marketing. We have the experience, and the tools, 

o make sure your World Wide Web pages aren’t...you know...dull. 

















We even have a Web server, so site maintenance and updates JOINT & JointSolutions Marketing 

a ee ; 7) = Tel: (408) 471-1500 

lon't slice into ue work time. ©) Ye > E-mail: info@jointsolutions.com 
Call us today and we'll take a whack at your Web needs. feat ~ hetp://www.jointsolutions.com 
TOP 20 CONTESTANTS 
Here are the Top Contestants for the Programmer’s Challenge. Here is Charles Higgins’ winning solution: 
The numbers below include points awarded over the 24 most recent Seu 
ae ndow.cpp 

contests, including points earned by this month’s entrants. Charles Higgins 
ee SS ae eee EE ee ee NT ere NNE Tee Re finclude “SortWindow.h” 
Rank Name Points Rank Name Points , 
~ “we tase ne a ae void swap(BWindow *aWindow, char **sl, char **s2); 
i. Munter, Ernst __ 182 1. Nicolle, Ludovic 2 char **addlist( BWindow *aWindow, char **list, int 
2. Gregg, Xan _ 114 12. _Picao, Miguel Cruz 21 numberOfThings) ; 

d. _larsson, Gustav 67,13. Brown, Jorg 207 SortWindow::SortWindow(BRect frame) 

4. Lengyel, Eric 40 14. Gundrum, Eric 20 : BWindow(frame, “Sort”, B_TITLED_WINDOW, 0) 

c=) ce ss | cate, 

_). Lewis, | Peter 4D Higgins, Charles 20 BRect aRect = frame; 

6. Boring, Randy 2716. Kasparian, Raffi 20 _ aie nee 
7. Cooper, Greg 2717. Slezak, Ken 20 aRect .0ffsetTo(B_ORIGIN) ; 

8. Antoniewicz, Andy 24 18. Studer, Thomas 20 aView = new BListView(aRect, “SortView”, 

sisi brane: asco Ie tc J itn 8 FOLLOW ALL, B WILL. DRAW): 

9. Beith, Gary 2419. Karsh, Bill, 19 this->AddChild (aView) ; 

10. Cutts, Kevin 21 20. Nevard, John  ——s.17 


. a void swap(BWindow *aWindow, char **sl, char **s2) 
There are three ways to earn points: (1) scoring in the top 5 ( 


of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that I use. The points you can win are: 


BView *aView; 
char *temp; 


aView = aWindow->FindView(“SortView”): 
aWindow->Lock(); 
temp = *s1; 


Ist place ........ 20 points Sth place... 2 points Ns ie a 
2nd place.......10 points MNGINS DUG scvesrieccancaes: 2 points aView->Invalidate() ; 
3rd place........7 points suggesting Challenge ...2 points enema ANNO: 


4th place........ 4 points 
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char **addlist( BWindow *aWindow, char **list, int 
numberOfThings) 
{ 

BListView *aView; 

int ae 


aView = (BListView* ) aWindow->FindView(“SortView”) ; 

aWindow->Lock(); 

for (i=0;i< numberOfThings;it++) 
aView->AddItem(list[il]); 

aWindow->Unlock(); 

return((char**)aView->Items()); 


void SortWindow: :DoSort ( 

char *thingsToSort[], int numberOfThings, SortType 
sortMethod) 
{ 


short is 

13 

k, 

sorted = FALSE; 
char **myList; 


myList = addlist( this, thingsToSort, numberOfThings) ; 
switch(sortMethod) 
case kBubbleSort: 
i = numberOfThings-1; 
while(i>0) 
{ 


= . 
’ 


12 
for (k=0;k<i;+tk) 
{ 


if (0 < stremp(myList [k] ,myList[j])) 


. 


aa 
swap( this, &myList[i], &myList[j]); 
i-; 

break; 


case kExchange: 
while(!sorted) 
( 
sorted = TRUE; 
for (i=0;i<numberOfThings-1;i++) 
{ 
if(0 < stremp(myList [i] ,myList[it1])) 
{ 
sorted = FALSE; 
swap( this, &myList[i], &myList[itl]); 


} 
J 


break; 
case kMySort: 
QuickSort( myList, 0, numberOfThings) ; 
break; 
memcpy (thingsToSort,myList,numberOfThings*sizeof(char*)); 
be_app->PostMessage(B_QUIT_REQUESTED)) ; 


Dilbert? by Scott Adams 


ACCORDING TO EINSTEIN, 
TIME SLOWS DOWN AS 
YOU APPROACH THE 
SPEED OF LIGHT. 


Reprinted by permission on UFS, Inc. 
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DIDN'T HE ALSO 
PROVE THAT TIME 
FLLES WHEN YOU'RE 
HAVING FUN ? 





©1997 United Feature Syndicate, Inc. (NYC) 


void SortWindow: :QuickSort( char **list, int first, int last) 
{ 


int Kees 


while(last - first > 1) 
{ 
Tifst: 
lasers 
ert.) 


J 





while(++i < last && stremp(list[i],list[first]) < 0) 
while (-j >» first && stremp(list[j],list[first]) > 0) 


if (4 »= j) 
break; 
swap( this, &list[i], &listlj]); 
} 
if( j == first) 
{ 


TrLirst ; 
continue; 
} 
swap( this, &list[first], &list[j]); 
1£{j.> first < last.= (7t1)) 
{ 
QuickSort( list,first,j); 
ritet = 7.7 13 
} 
else 
( 
QuickSort( dist, itl, last); 
last = 43 
} 


} 
SortWindow.h 


typedef enum SortType { 
kBubbleSort = 1, 
kExchange = 2, 
kExchangeSort = 2, 
kMySort = 3 

} SortType; 


class SortWindow : public BWindow { 


publics 
SortWindow(BRect frame); 


virtual void DoSort( char *thingsToSort[], 
int numberOfThings, 
SortType sortMethod) ; 


virtual void QuickSort( char **list, int first, int last); 


3 





50, IF YOU WALK 
SLOWER , DO YOU 
HAVE MORE FUN OR 
JUST GET MORE 
LIGHT ? 


WERE WE 
FINISHED 





MACTECHMAGAZINE ®@ ApRIL 1997 
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FACTORY 
FLOOR 





By Dave Mark, ©1997 by Metrowerks, Inc., all rights reserved. 








Avie Tevanian, Apple’s New OSMeister 





This month’s Factory Floor interview is with 
Avie Tevanian, Vice President of Engineering 
at NeXT, Inc., and recently appointed 
OSMeister at Apple. Avie is charged with 
bringing NeXT’s OS technologies together 
with Apple’s and producing Apple’s next OS, 
code-named Rhapsody. 


Dave: What will become of the 
existing Mac Toolbox? Will the 
investment developers are making 
in mastering the existing Toolbox 
be devalued as Rhapsody kicks in? 
Will Mac apps that run under 
today’s System software continue 
to run under Rhapsody? If so, will 
this solution be a compatibility 
box like MAE? 


Avie: Keep in mind that the System 7 
based MacOS is going to be supported 
for a long time and that developers 
can keep their investment in this 
architecture and port to Rhapsody at 
their own pace. Many of the existing 
toolbox resources are being ported to 
Rhapsody. 


Additionally, most applications that 
run under System 7 today will run on 
Rhapsody via the “blue box” which is 
not an emulation environment, rather 


it provides native access for System 7 
apps at great speeds. 
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Dave: What can you tell us about the overall Rhapsody 
architecture? Will it be the OpenStep architecture with 
some modifications? Will any of the Macintosh 
architecture survive? Will resources (a la ResEdit) be 
part of Rhapsody? 








Avie: = Many aspects of the existing Macintosh architecture will 
exist in Rhapsody such as QTML (The QuickTime Media 
Layer). The “yellow box” included in the attached picture 
represents the new APIs based on OPENSTEP. These APIs will 
allow developers to build better applications faster. These 
apps will enjoy new features such as multitasking, 
multithreading, protected memory, etc. We plan on making 
these APIs public as soon as possible for developers to 
become familiar with Rhapsody’s capabilities. 


Dave: What will be done to make the new architecture 
thread-friendly? 


Avie: The CoreOS has full support for threads, allowing 
multiple threads of execution to run in parallel on 
multiprocessor systems. Additionally, there is full support for 
thread synchronization and communication. 
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We've worked with multi-threaded programs for a long 
time. Sometimes they can be challenging to get working 
correctly. After all, there are a lot of synchronization issues 
to worry about. However, the multi-threaded model often 
leads to significant simplification of applications with 
partitionable functionality yet retains a high degree of state 
(memory) sharing. 


Dave: What can you tell us about the Rhapsody kernel? 
Will NewOS be based on Mach? The Copland Kernel? A 
combination of both? 


Avie: — Fortunately Apple now has the option of incorporating 
a variety of new capabilities in their “core os” based on a 
number of kernel choices. We have not yet announced what 
the primary source base will be. What’s important is the fact 
that it will support true multitasking, protected memory, and 
SMP. In anycase, I see us drawing on many of the code and 
ideas from many sources. “Just as we went to press Apple 
announced their plans to use a Mach kernel, but not which 
version of Mach. —Eric]” 


Dave: What will the Rhapsody user interface look like? 
Will it resemble the existing NeXT interface? For 
example, will the menu bar be the NeXT menu list or 
the more familiar Mac menu bar? 


Avie: Our goal for the UI is to have it maintain the true spirit 
of the Macintosh while also making it become much more 
powerful. We’ll draw on some of the best aspects of the 
NEXTSTEP UI and the existing Macintosh UI and deliver a 
world-class solution. 


Dave: Will Objective-C become the standard language 
for future Mac development? Will there be any role for 
languages like C, C++, and Pascal? How will non- 
Objective-C languages work with Rhapsody? Will there 
be a set of APIs for languages other than Objective-C? 


Avie: | Metroworks has committed to providing Rhapsody 
development tools in a variety of languages. In addition, we 
have committed to start supporting Java based APIs within 
Rhapsody and expect that these APIs will become much more 
prevalent over time. 


Finally, the Objective-C runtime is a simple ANSI C callable 
set of api’s. It can be called directly from any language. 
We’ve found that many developers prefer to program in 
Objective-C once they’ve learned it — and learning it is not 
hard at all. However, we will not force developers to use 
Objective-C. 
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Dave: The newsgroups are saying that the performance 
of C and stack-based C++ is much greater (in terms of 
function dispatch speeds, for example) than Objective- 
C. What’s your experience in this regard? 


Avie: Rhapsody gives developers the option of also writing 
straight C and C++ code. Objective-C offers dynamic 
runtime binding giving developers capabilities that aren't 
possible in C or C++. While there is some overhead to 
dynamic binding, developers have the choice to statically or 
dynamically bind their objects in the system. We have had 
good experience building large systems using the dynamic 
features of Objective-C (all of NEXTSTEP uses it!). We don’t 
see performance as being a problem at all. 


Dave: Again from the newsgroups, there is concern 
that Display Postscript running on a PC offers some 
performance concerns. For example, window 
dragging is perceptibly slower than under NT or 
Win95, even on a 200Mhz Pentium. Will Display 
Postscript become part of the new OS? If not, what 
imaging model will be used? 


Avie: Our intent is to use Display Postscript for the imaging 
model. Users will be impressed with the speed of window 
operations as well as the flexibility for output devices. In 
addition, other APIs will be provided for performing fast, 
direct to screen operations as would be used in multimedia, 
games, etc. 


Dave: What is the plan for Java integration with 
Rhapsody? With Objective-C? 


Avie: Apple is committed to Java and plans on adding Java 
APIs to Rhapsody. NeXT has already integrated Java into 
WebObjects such that developers can write their entire 
program in Java. Fortunately, the Java design is very close 
to the Objective-C design, with the primary difference 
being the syntax. In fact, Java was explicited designed with 
Objective-C-like functionality in mind. Java is a great match 
for our Objective-C technology, and you'll see us doing lots 
of interesting things with Java in general. 


Dave: Is SOM officially out of the picture for Objective- 
C? Is there an alternative in mind? 


Avie: We haven't looked at this in detail but it seems as 
though it would be technically feasible for SOM to 


interoperate with Objective-C. 


Dave: Assuming that developers will need to retool and 
retrain to develop for NewOS, what can you say 
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Avie: — Rhapsody will allow developers to build new “best of 
breed” applications. They can focus on adding their own value 
to their apps rather than spending a lot of time, money and 
energy trying to make their apps work in Windows. 


Further, it is false to assume that a “switch over to Windows” 
is less risky. In truth, competition in the Windows space is 
very difficult with shelf space given only to the largest 
developers with development budgets of tens of millions of 
dollars. To get your product on Windows you first have to 
compromise on the features, then you have to fight it out in 
the market (probably against Microsoft). Developers should 
be able to build a very nice business off their Rhapsody- 
based applications! 





The fastest, cost effective way to get product off your shelves. 
For information: ® Voice: 805/494-9797 © Fax: 805/494-9798 © E-mail: marketing@devdepot.com 
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By Jessica Courtney 





ABSOFT PRO FORTRAN 


Absoft is pleased to announce Pro Fortran, a new Fortran 
toolset for Power Macintosh. Pro Fortran is a complete 
development toolset which includes: F90 compiler, upgraded 
VAX compatible F77, and Plum Hall validated C/C++ compilers. 
All compilers utilize a common development environment, tools 
and user interface (individual compiler interfaces are also 
included). All languages are link compatible and mixed language 
applications can easily be created. 

Absoft’s primary focus remains on Fortran compilers. The 
new F90 compiler is the first available for Power Macintosh. The 
upgraded F77, designed for porting legacy workstation code to 
the desktop now includes LS F77 extensions. New compile and 
runtime options allow byte swapping for porting code to/from 
Intel. The C/C++ compilers are included for those wishing mixed 
language development in a single environment. 

Special upgrade pricing is available for existing Absoft and LS 
Fortran users. Contact Absoft at <http:/Avww.absoft.com> for details. 


FORTNER RESEARCH INTRODUCES POWERTAP 

Fortner Research announces the release of PowerTap, a 
software library that can add multi-processing support to 
Macintosh applications. As new software becomes more 
complex, hardware manufacturers are having to deliver 
comparably powerful desktop systems. In turn, developers must 
spend additional resources reprogramming applications to take 
advantage of this new hardware. Such development is costly and 
may only reach small markets that purchase the new machines. 
This is where PowerTap can make a difference. 

Powerlap is a new software development tool that bridges 
the gap for Macintosh developers in the never-ending race for 
the highest technology. PowerTap provides two specific 
solutions to this problem. First, PowerTap turns any Macintosh 
network into a multi-processing powerhouse by scheduling tasks 
to run not only on the host CPU, but on any networked machine 
set up to relinquish time to that application. By accessing these 
available processors, applications can execute in a fraction of the 
time. Second, PowerTap makes it simple to provide support to 
the new lines of multi-processing machines released by Apple, 
Daystar and other Mac Clone manufacturers. PowerTap’s 
capabilities are extremely versatile and allow developers to 
harness the power in a network or MP computer with literally no 
additional expenditures in hardware. 

For more information on PowerTap and other procucts by 
Fortner Research, visit Fortner Research’s Web site at 
<www.fortner.com>. 


NEWSBITS 


APPLE INTRODUCES HIGH-QUALITY MPEG SOFTWARE FOR 
QUICKTIME 


New QuickTime Extension Allows Playback of Popular 
MPEG-1 and VideoCD on PowerPC MacOS Systems 

Apple Computer, Inc.announces immediate availability of 
the QuickTime MPEG (Moving Picture Experts Group) extension, 
enabling full-screen, software-only playback of MPEG-1 and 
VideoCD audio/video files on PowerPC MacOS computers. The 
MPEG extension is available immediately for use with QuickTime 
2.5 and may be downloaded from the QuickTime web site at 
<http://quicktime.apple.com/>. 

Through the MPEG extension, VHS-quality, full-screen video, 
and CD-quality audio are now available as a synchronized data 
type in the QuickTime architecture. Apple has long recognized 
MPEG as an important industry standard and has supported 
hardware MPEG-1 playback on Macintosh since 1994. With the 
announcement of this QuickTime Media Layer (QTML) software 
extension, Power Macintosh users no longer need special 
hardware to view a variety of MPEG files and formats. 

The MPEG extension will also work with the QuickTime 
plug-in for Netscape Navigator and Microsoft Internet Explorer, 
enabling real-time, live MPEG playback inside these browsers. 
QuickTime’s ‘fast start’ feature enables MPEG content to be 
viewed as it downloads, eliminating the delay associated with 
large multimedia files across low-bandwidth connections. 

The extension is compatible with a wide range of Internet- 
based MPEG, including Variable Bit Rate (VBR), MPEG, audio 
only or video only streams, and can read specialized MPEG 
encoded streams, broadening the ability for publishers to deliver 
interactive titles for Macintosh and Intel-based audiences. 

The QuickTime MPEG software extension enables high quality 
software video decoding on personal computers. QuickTime 
provides a number of new capabilities for MPEG compressed 
media, a characteristic of codes and media types playing under the 
QuickTime platform. 

All applications updated to be compliant with QuickTime 
for Macintosh 2.5 can immediately take advantage of these new 
features. Users should check with their tool vendor for 
compliance. Apple is providing a new version of MoviePlayer, 
version 2.5.1, to allow immediate use of these features. Apple is 
committed to giving Windows customers an equally compelling 
MPEG experience in 1997. 

The MPEG extension can upgrade systems currently installed 
with QuickTime for Macintosh 2.5 due to the extensibility of QTML 
and the open plug-in architecture of QuickTime. 
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METROWERKS TO ACQUIRE LATITUDE PORTING TECHNOLOGY 


Metrowerks Inc. announces that it had signed a letter of 
intention to acquire the principle assets of The Latitude Group, 
Inc., of Mountain View, Calif. Latitude’s principle assets include 
a porting library which allows MacOS applications to be ported 
to unIx-hosted operating systems, including Sun Microsystems’ 
Solaris 2.3+, Silicon Graphics’ IRIX 5.2+ and Hewlett-Packard’s 
HP-UX 9.03+. The Latitude porting libraries redirect MacOS 
commands to the target operating system, with a UNIX library 
containing a portable implementation of the MacOS API at its 
core. Metrowerks will also take over providing the Latitude 
porting technology to The Latitude Group, Inc.’s existing clients 
already under contract. 

Metrowerks intends to use the Latitude porting library to port 
CodeWarrior to run on Sun Microsystems’ Solaris-based UNIX 
workstations in order to offer this platform as a host for embedded 
systems development. Sun’s Solaris-based uNIx workstations are 
widely used by embedded systems programmers worldwide. 

The Latitude porting libraries will be incorporated in a new 
product, CodeWarrior Latitude. CodeWarrior Latitude will continue 
to support the unrx-hosted operating systems outlined above. 

Metrowerks also plans to extend CodeWarrior Latitude to 
enable the port of MacOS applications to run on Rhapsody, 
Apple’s Next Generation OS. This will allow Metrowerks’ existing 
clients to more easily port their existing applications to Rhapsody. 

As part of the agreement between Metrowerks and The 
Latitude Group, Inc., David Hempling, president and CEO of The 
Latitude Group, Inc., will join Metrowerks as the technical lead for 
CodeWarrior Latitude. Mr. Hempling was a co-founder of Quorum 
Software Systems Inc., which created Latitude. 

Metrowerks plans to ship CodeWarrior Latitude in the summer 
of 1997. CodeWarrior Latitude will include all available targets 
(Silicon Graphics, Hewlett-Packard, Solaris and Rhapsody) in one 
library package and will sell for $399. 


FORTRAN COMPILER SOON TO BE AVAILABLE FOR METROWERKS 
CODEWARRIOR 

Fortner Research, developers of software for scientists and 
engineers, has announced their plans to deliver LS Fortran for 
CodeWarrior. CodeWarrior owners will now be able to use LS 
Fortran to write and compile Fortran programs directly in the 
CodeWarrior environment, and mix Fortran routines with C, C++ 
and Pascal software, such as the PowerTap MP library. 

Since 1988, LS Fortran has gained a strong following for 
its ability to port large, legacy Fortran programs from 
mainframe computers to the Macintosh and for its ease in 
creating full-featured Macintosh applications. LS Fortran is 
currently hosted in the Macintosh Programmers Workshop 
(MPW), developed by Apple Computer. Although MPW’s 
command line interface environment was the standard for 
many years, CodeWarrior delivers an extremely popular GUI 
with superior project management that enables programmers 
to spend more time programming, and less time on the 
tedious task of project set-up. 
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Fortner Research expects to begin shipping LS Fortran for 
CodeWarrior by March. Current users of CodeWarrior and LS 
Fortran for MPW will be able to purchase LS Fortran for 
CodeWarrior at a special introductory price. 

For more information on LS Fortran for CodeWarrior and 
other products by Fortner Research, visit Fortner Research’s Web 
site at <www.fortner.com>. 


VOODOO 1.8 INTEGRATES VERSION CONTROL INTO 
CODEWARRIOR 
New release 1.8 of the popular version control tool 
VOODOO offers scriptability and integration into 
Metrowerks CodeWarrior IDE. 

UNI Software Plus announces that the new version 1.8 of 
its popular version control tool VOODOO will be released 
soon. In order to bring the new features to the customers as 
soon as possible UNI Software Plus further announced the 
immediate availability of a full functional free pre-release of 
VOODOO 1.8. 

In version 1.8 the delta generation process has been 
improved again and is much faster. Besides that, the new version 
supports even the comparison of files of different types. Right 
now VOODOO can display the differences of text files, MS Word 
files and resource files using different helper applications. Other 
file types will follow. 

A pre-release of VOODOO 1.8 available for download 
from <http://www.unisoft.co.at/e/products/voodoo.html>. This pre- 
release is intended for demonstrating many of the new 
features of version 1.8. It will never be sold but can be freely 
used by anybody for evaluation purposes. The pre-release 
will expire on April 30, 1997. At that time, the final version 
will be available. While the unregistered version offers full 
functionality on projects not older than 3 months, registered 
versions are fully functional until the expiring date. This 
allows existing customers to start working with the new 
version immediately. 

VOODOO (Versions Of Outdated Documents Organized 
Orthogonally) is a stand-alone version control tool with a neat 
graphical user interface offering many features for the simple 
and clear management of projects in which files evolve in 
numerous versions. The tool manages not only variants and 
revisions of single files, but of whole software projects (multiple 
files, multiple users, multiple variants, access rights, project 
structure, project history, etc.) 

VOODOO differs from previous source code control 
systems in its orthogonal approach to version management. 
This means that for every component of a project hierarchy 
you can not only store its revision history but also different 
variants of the same component. The orthogonal 
organization of revisions and variants leads to a much clearer 
organization than with other tools which use trees for 
organizing variants and revisions. TWH 
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By Steve Sisak 





DEBUGGING 68K CODE RESOURCES WITH MACSBUG 


I’m using a CDEF as an example here, but this 
technique can be quite useful in many situations. 

I recently had the pleasure of writing a tiny 
application for an old client. There was actually more code 
in the custom CDEF than the app itself. Once it was all 
polished and “bug free” I took it to the client’s site for a 
demo. Naturally, it crashed immediately on launch. 
Everything froze up and I had to do a hard reset. I strongly 
suspected my CDEF was the problem. Normally, I would 


put a Debugstr in the CDEF, recompile, and use MacsBug’ 


to find the problem. But this was a 4MB LCII. There was 

no chance of installing CodeWarrior and rebuilding the 

CDEF. However, the computer did have an old copy of 

ResEdit. The following is what I did. 

1) I opened my application in ResEdit and used the 
GetInfo dialog to make my CDEF preloaded and 
locked. I then saved the file and quit ResEdit. 

2) In MacsBug, I set an A-trap break on InitGraf. 

atb _InitGraf 

3) I launched my app. Since initializing QuickDraw is 
one of the first things my program does, my A-trap 
break fired and I dropped into MacsBug. 

4) The MacOS automatically loads preloaded resources 
when the resource file is open, so I found my CDEF 
in memory and set a breakpoint. To find the 
resource, I typed “hd RS” (list all resources in the 
current heap). 





_ Sena us your tips or we'll install EvenBetterBusError on your machine! On the other hand, we might just pay you $25 for each tip we use, or $50 





The screen looked something like this 


hd RS 
Displaying the “Quick Launch” heap at 00192830 
Start Length Tag MstrPtrLock Prg Type ID 
00194890 00000544 R 00192A00 L CODE 0001 
00196872 00000A44 R 00192A04 LE CDEP 0080 
ClCus 


5) Since my CDEF was already loaded in memory, and locked 
down, I set a breakpoint at the beginning of the CDEF. 
br 00196872 

I then typed command-g to continue. My breakpoint was 
soon hit and the bug identified. I fixed the problem the next day 
and got paid. This technique can be used to set a breakpoint at 

the beginning of nearly any code resource. 
Damon Cokenias 
<hitp.//www.netgate.net/~cokenias> 


SHOP H SOSH HEH EEHHEEEEEHSEEEESEEHOES OHHH EE EEOOTEOOEEEOHH EEE HOES EE SEES EEESEEHS ESSE SOS EE SHOES ESEHEESSEOH OOOOH ES ESEE SEES OES ESELEES 


In the MacTech 13.02 (February 1997) we printed a tip from 
Bill Hayden that System 7.5.3 made it possible to navigate the 
Standard File dialog box by clicking items visible on the desktop. 
Since then, a number of readers have written to report they could 
not reproduce this behavior. 

After trying a variety of system software releases, we have 
not found a publicly released version of the system exhibiting 
this behavior, although one reader has reported reproducing it 
on a version of System 7.5.3 release 2 but not 7.5.5. 

We offer two possible explanations for the source of the tip. 
First is a freeware utility called “Click, there it is!”, by Richard 
Cardona Utilities Group (now in version 1.0.7), which enables 
the behavior described in the tip. A second possible explanation 
is that the reported functionality may have been enabled in a 
developer release of system software, but removed from the 
final, public release. 

In any case, we apologize for the error and thank everyone 
who took the time to report it, as well as those who have taken 
the time to submit tips — please keep them coming. 

Best wishes, 

--Steve 
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By MacTech Editorial Staff 








BOLo Is A PBREAD COMPLETION ROUTINE 
Dear Editor, 

I was pleased to see the article in MacTech December 1996 
encouraging programmers to use asynchronous I/O, but 
unfortunately some of the details in the article were not correct. 
Richard Clark wrote “The completion routine for PBRead is 
especially poor, as it receives no parameters... This routine 
appears to have A5 set up for it...” 

Firstly, the PBRead completion routine does get passed a 
parameter (a pointer to the parameter block that has just 
completed) and secondly, A5 is not guaranteed to be set up to 
point at your globals. AS will be pointing to the globals of 
whichever application was interrupted to execute the completion 
routine (which might even be your own application, which is why 
A5 may sometimes appear to be set up correctly). If your 
completion routine tries to access your program’s globals without 
first making sure to set up A5 correctly, the Mac will crash. 

Fortunately, there’s no problem as long as you know how to 
deal with it: Because the PBRead completion routine gets passed 
a pointer to the parameter block, you can use this to pass it as 
many extra parameters as you like. 

1. Define a new “extended” PBRead parameter block like this 
typedef struct 

er anew 

void *regA5; 

short my_parameter; 


// ... and, so on, as many as you like 
} ex_ioParam; 


2. Before you call PBRead, fill in the parameters that you want the 
completion routine to get (especially the Register A5 value). 


static ex_ioParam pb; pb.io.ioCompletion = CompletionRoutine; 
pb.io.ioRefNum = refnum; 

// ... and so on 

pb.regA5 = GetGlobalsRegister () ; 

PBRead ( (ParmBlkPtr) &pb, TRUE) ; 


3. In the completion routine, set up the correct A5 value and 
access other parameters as necessary: 


static void CompletionRoutine (void) 

{ 

register ex_ioParam *pb = GetRegisterA0(); register void* 
oldGlobalsReg = SetGlobalsRegister(pb->regA5) ; 

// ... Do your stuff 

SetGlobalsRegister(oldGlobalsReg) ; 

} 


If you don’t already have the 68K register accessor functions 
defined, they are: 


pragma parameter __DO GetRegisterD0() //MOVEA.LDO,DO local 
void* GetRegisterDO(void) = { 0x2000 }; 
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// MOVEA.L A4,A0 local 





#pragma parameter __AO GetRegisterA4() 

void* GetRegisterA4(void) = { 0x204C }; 

#pragma parameter __AO GetRegisterA5() //MOVEA.LA5,A0 local 
void* GetRegisterA5 (void) = { 0x204D }; 

#pragma parameter __AO SetRegisterA4(__A0) // EXG A0,A4 local 
void* SetRegisterA4(void*) = { OxC14C }; 

pragma parameter __AO SetRegisterA5(__AO) // EXG A0,A5 local 
void* SetRegisterA5(void*) = { OxC14D }; 


ifdef THINK_C 

#if __option(a4_globals) 
define A4SGLOBALS 
fFendif 

ffendif 


ifdef _ MWERKS _ 
if ! AS 
#tdefine A4SGLOBALS 
frendif 

fFendif 


itifdef A4GLOBALS 

define GetGlobalsRegister GetRegisterA4 
#define SetGlobalsRegister SetRegisterA4 
else 

#define GetGlobalsRegister GetRegisterA5 
define SetGlobalsRegister SetRegisterA5 
itendif 


You can do a hell of a lot with completion routines, as long 
as you don’t try to call QuickDraw, the Memory Manager, or 
make synchronous calls. The entire game of Bolo is basically one 
huge completion routine, which is why you can switch to 
Microsoft Word, pull down a menu, and sit there holding the 
mouse button down, without affecting the game of Bolo at all. 
That’s why I’ve never really understood all the people who 
continuously complain that the Mac needs preemptive mullti- 
tasking. Sure, preemptive multi-tasking makes the programming 
easier, but it doesn’t fundamentally change what you can do. In 
fact it makes some things worse — with asynchronous I/O your 
completion routine gets called immediately when the operation 
is complete, where as with preemptive multi-tasking you're at the 
mercy of some scheduler that decides when your code next 
deserves to get a slice of CPU time. 


Stuart Cheshire <cheshire@cs.stanford.edu> 





THE GUIDING LIGHT 

Not sure if I’m the first to point this out to you, but... I’m just 
looking at the “MacTech Now” ad on page 77 of the February 
issue. I see shadows behind the logo text at the top. And... The 
shadows don’t match up! The ones behind the letters of the word 
“MacTech” indicate a light source above and to the left, but the 
ones behind the word “Now!” indicates a light source that’s 
above and to the right! 


DIALOG Box 


Actually, Lawrence, the MacTechNOW logo was developed 
using an as yet unreleased QuickDraw3D derivative technology 
called QuickDrawMPYV. This technology allows the simultaneous 
use of multiple points of view, resulting in shadows going in 
more than one direction. We chose to use QuickDrawMPV 
because it best represents how the MacTechNOW site provides 
information from more than one source. 

We hope to offer more information about QuickDrawMPV 
in a future issue, assuming Apple doesn't see this technology as 
the joke it really is and refuse to acknowledge its existance. 

Thanks for your note; I really wanted something like this 
for April, and you provided it. :-) 


Eric Gundrum, Editor-in-Chief 





| MORE BEGINNING ARTICLES, PLEASE 

Dear Editor, 

I wanted to take a moment to respond to the Viewpoint 
article by Eric Gundrum in the December ‘90 issue. 

I’m a subscriber that appreciates seeing articles targeted 
toward the beginning programmer. I can recall two recent articles 
that were of this category: Peter N. Lewis on memory issues and 
Mark Aldritt (1 think) on tips for making AppleScripts run faster. It 
would be nice if each issue had one article targeted to beg:nners (a 
regular column?). My guess is that there is room for it, but most 
writers are less interested in the beginners audience. I don’t know 
how many people (non-participants) read the programmer’s 
challenge, but it seems to be one of the best opportunities for 
experienced programmers to learn new tricks and approaches. It’s 
good that this department will be enhanced in future articles. 

Mr. Gundrum also noted that more code examples would be 
given. Please stress that your authors should heavily comment 
their code. Also, wouldn’t it be possible to archive the more 
detailed code on your website? That way you don’t have to fill up 
your magazine pages with code, and the readers could retrieve it 
in digital form to avoid re-typing it. You could print a URL for that 
month’s issue. 

The vast majority of the magazine is over my head, but that’s 
my own problem. I currently only have time to dabble — I’m 
working on trying to change that. The subscription is worth it to 
me just to stay abreast of what’s happening. 

Here are some suggestions for beginner's topics: 

1) An article that addresses the upcoming changes to the MacOS 
and how a true beginner should prepare. (Admittedly, Apple is 
making it harder for you to anticipate the new OS.) I have 
purchased several beginners books that cover the current OS. 
However, I occasionally read about how the Event loop 
paradigm will change in MacOS 8. Then there’s the scrapping 
of CDEVs and INITs. I worry that I’m learning things that will 
no longer be in use after another year or two. Are things going 
to change so much that it would be better to just wait, 
especially if the BeOS is adopted? 


DIALOG Box 


2) Surprisingly, I have not encountered a review of the binary 
foundation of programming in the Mac programming books. 
My ideal review would cover all the “lowest level” 
representations and their manipulation, such as octal, 
hexadecimal, setting bits, bit-wise shifts, etc. For example, 
while it’s quite obvious to me why computers speak binary, I 
don’t know what the value of hexadecimal is. ’m sure that 
seems like a very ignorant question to an experienced 
programmer. It may be typical from someone who was not a 
math or computer science major in college. 

3) An article that addresses approaches to information storage 
(struct design): what are the best ways to store numbers, text, 
pictures, etc. Sample databases seem to be the best vehicle for 
illustrating these points. What should one think about in the 
design stage to ensure later speed and flexibility? 

4) An article that focuses on GUI design: when I use Mac 
programs I often wonder how the programmers implement 
certain design features. Usually this entails linking underlying 
data to some element of the GUI — dragging list selections 
from a “source” to a “target”, double-clicking a certain region 
to invoke an action. Another good example: in a full-featured 
word processing program that permits styling and coloring of 
text, how are these attributes stored when TextEdit is not 
being used? How does one calculate the physical dimensions 
of text data, ie. how do you implement a print preview 
function that gives a “to scale” WYSIWIG representation of the 
data? I realize that these are pretty advanced issues. 

5) Manipulation of strings: sorting, searching, pattern matching, 
connection to the GUI Ge. double-clicking selects a word). 

I’m sure I'll think of a few more... 


Michael Myers <myersm@rockvax.rockefeller.edu> 


Michael, your point is well taken. The MacTech readership 
is a very diverse group, including nearly equal numbers of 
readers at all levels of programming expertise. I agree that 
every issue should include at least one more article for 
beginning programmers, and I am working with authors to 
get those articles written. 

The complete project files for all of our articles are posted 
to the MacTech ftp site, available through MacTechNOW, when 
the issue ships. When asking an author to include code for an 
article, I ask that only enough of the code be included so the 
article can be read without your having to print pages of code 
from the ftp site. This leaves more space for explanations of the 
relevant points. 

The articles you suggest are an excellent starting point. 
Keep those suggestions coming. 


Eric Gundrum, Editor-in-Chief 
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(...and we really mean now.) 


Think of it as your source of news and announcements in the 
MacOS developer community. Loaded with up to the latest news, 
and constantly updated with developments in our industry. 


MacTech NOW” brings you up to speed on everything you need to 
know — instantly! And thanks to our new “fast-download” design, 
you'll get to the information you want in seconds. 


Give it a spin! Check it out today and get access to over 1500 pages 
loaded with news, tips, programming secrets, product reviews, and 
much more. And for those of you looking for some kicks, there’s the 
ever popular “Programmer’s Challenge” section where you'll get to 
bang heads with the best in the community. 


Log on to MacTech NOW. Things are happening right now, and you 
should be aware of them. 
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Developer Depot 30 day Money Back, Price and 

Satisfaction Guarantee 

Developer Depot products are sold with a 30 Day money back guarantee on 
user satisfaction, lower prices and against defects. If, for any reason, you are 
not satisfied or find the same product at a lower price within 30 days, please 
call Customer Service at 800-MACDEV-1 and request a Return Merchandise 
Authorization (RMA) number to get a full refund or the difference in price 
(where applicable). You must return undamaged product at your expense, 
including all its original packaging, documentation and the blank warranty 
card if applicable. Developer Depot will replace defective product upon 


Stuff our lawyer made us write. 
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Subscriptions: US magazine: $47 for 12 issues (MTYRDM) 
Canadian: $59 for 12 issues (MTYRCM) 

International: $97 for 12 issues (MTYRFM) 

Back Issues: $10 each (Subject to availab lity) 





MacTech CD-ROM Volumes 1-11 


e 1420+ articles, from all 127 issues of MacTech Magazine (1984-1995) 
e |mproved hypertext, and a new THINK Reference Viewer - for lightning 
quick access! New hyperlinks between articles 
— ctl e 100+ MB of source code - use them in your applications, 
with no royalties! 
e Full version of THINK Reference™ — the original online 
guide to Inside Macintosh, Vols. I-VI 
© 80MB of FrameWorks/SFA archives and the most complete set of 
FrameWorks archives known 





imited time offer*Buy 
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| olume 11 NOW and geta ¢ Sprocket™! MacTech’s Tiny Framework that compiles quickly 
, ree upgrade to the soon- and supports System 7.5 features 


e The best threads from the Macintosh programmer newsgroups 
_ha- | 
to-be-released Volume 12! plus thousands of notes, tips, snippets, and gotchas 


Free shipping on the upgrade! e Popular tools that Macintosh programmers use to increase their 
productivity and much more! 


List $89 Our Price $79 (SMTCD11) 
Upgrades: Our Price $39 (SMTCD11U) 


MacTech Mouse Pad 


Slide on this! With an extra-large surface (11” by 10”) anda 
deluxe sleek plastic coating, you'll be Zooming across your 
screen in no time at all. Speed limit not enforced! 


Our Price $8.95 (AMTPAD) 
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AppleScript Software 


Development Toolkit 1.1 
by Apple Computer, Inc. 


e AppleScript language, system software 
extension, and script editor 

e Facespan 1.0 

e Developer’s redistribution license for 
AppleScript System software extension 
and FaceSpan runtime code 


Our Price $49 (SASDT) 


Apple Media Tool 


Programming Environment 2.0 
by Apple Computer, Inc. 


e This object-oriented language and application framework 
allows programmers to customize features used within the 
Apple Media Tool authoring environment 

e Includes an expanded Apple Media Language (AML) class 
library, incremental compiling and linking of AML code, faster 
debugging facilities, Macintosh Programmers’ Workshop 
(MPW), and user-oriented documentation written from an 
AMTPE developer’s perspective | 

e Portable across 68K, Power Macintosh, and Windows platforms 


Our Price $995 (SAMTPE) 








Object-Oriented Fundamentals 1.1 
by Apple Computer, Inc. 


e DU’s multimedia Object-Oriented Fundamentals course enables 
you to easily make the paradigm shift from procedural to 
object-oriented design. It will introduce you to the entire object 
skill set, from general concepts through analysis and design 

e This course includes a “lite” version of Metrowerks 
CodeWarrior integrated development environment for use in 
the labs. This course also includes a copy of the book Learn 
C++ on the Macintosh by Dave Mark 


Our Price $245 (SOBORFU) 


Newton Toolkit 1.6 
by Apple Computer, Inc. 


With Newton Toolkit, you can easily — 

create software that runs on any 

Newton PDA, including Apple’s 

MessagePad and Motorola’s Marco 

e Now supports Newton 2.0 

e Dynamic Language Eases 
Development 


Newton Programmer’s 


Guide for Newton 2.0 
by Apple Computer, Inc. 


e The Newton Programmer’s Guide consists of two volumes 
covering the Newton System Software, and one volume 
covering Newton Communications 

e The two-volume set, Newton Programmer's Guide: System 
software, is the definitive guide and reference for Newton 

ee | programming. This set of volumes explains how to write 

* Allows you develop applications interactively Newton programs and describes the system software 

e New Compiler Enables Faster Applications routines that you can use to do so 


Newton Toolkit 1.6 Our Price $299 (SNETO) e The Newton Programmer’s Guide: Communications, 


Newton Toolkit Update 1.6 Our Price $49 (SNETOUP) sale oe communications system software 
or version 2. 


Our Price $149 (BNPGEN) 
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QuickTime VR 2.0 Authoring Tools Suite 
by Apple Computer, Inc. 


© QuickTime VR is a cross-platform software from Apple which 
enables webpage designers and professional developers to 
create new multimedia products and webpages incorporating 
QuickTime VR content. With QuickTime VR, users interactively 
navigate through 360° views of space, and explore three 
dimensional objects on Macintosh or Windows-based personal 
computers 

e The QuickTime VR Authoring Tools Suite is a set of Macintosh 
tools to create and link panoramas and objects from 
photographic, digital, video, or computer generated images 

e Included is a complete set of documentation for planning, 
designing, photographing, and creating QuickTime VR panoramas 
and objects. The authoring tools also allow you to link objects 
to panoramas using clickable hot spots 


Included on the CDs are: 

e A software tool (MPW-based) that stitches and blends adjacent 
images into a panoramic PICT file 

e A software tool (MPW-based) that dices and compresses 
panoramic PICT files to less than 100 KE (low resolution) per 
panorama 

e A scene editor (HyperCard-based) to creete QuickTime VR 
scenes by adding and positioning nodes, hot spots, linking 
nodes together, and for linking QuickTime VR objects to scenes 

e A variety of utility tools for formatting the data into the 
runtime software 


Due to a revolutionary distortion-correcting algorithm, QuickTime 
VR panoramas and objects maintain a normal perspective when 
the user moves the mouse. The speed of the algorithm allows up 
to 24-bit color images. Both vertical and horizontal panning can 
occur at fast speeds. 


Our Price $395 (SQTVRATS) 





QuickTime Developer’s Kit 2.0 
by Apple Computer, Inc. 


e QuickTime 2.0 Extension, QuickTime Power Macintosh 
Extension, and QuickTime Musical Instruments extension 

e Utilities like MoviePlayer 2.0, 16-bit Audio Compression, etc. 

e Sample content such as MPEG Movies, Music Movies, 
Time-Code Movies, and 60 field per second movies 

e Includes software-only playback features such as faster 2x 
playback mode for current compressors, Apple Cinepak 
compressor, 1-bit fast dithering, network tuning, load-into-RAM 
option, and Photo CD support 


Our Price $99 (saTDk) 





Virtual Reality Programming with 


QuickTime VR 2.0 
by Apple Computer, Inc. 


e Virtual Reality Programming Book/CD-ROM for QuickTime VR 

e Enables you to write C and C++ programs using QuickTime VF 

e Allows QuickTime VR to be used in games, multimedia title 
and other programs 

e QuickTime VR 2.0 objects can be zoomed in on, panned, o 
linked with hots spots 

e Both panoramas and objects have hot spots linked to Worlc 
Wide Web URLs 


Our Price $49 (SVRPQT) 


Multimedia Authoring 
with Apple Media Tool 


by Apple Computer, Inc. 


Apple Media Tool offers new multimedia users a way to get 
started creating interactive multimedia with minimal learning 
time. This self-paced tutorial will make Apple Media Tool (AMI 
even easier to understand and to use. Using this tutorial, you ' 
create a realistic multimedia project using exciting techniques 
such as QuickTime movies, animation and more. A demo vers 
of AMT is included and can be used for the exercises. Trainin¢ 
Format: Tutorial with labs. 


Our Price $49.95 (SMWAMm) 





® Apple Dylan 


a dynamic object oriented language and development environment 


Apple Dylan Technology Release 
by Apple Computer, Inc. 


e Contains a PowerPC-native prototype version of a developm« 
environment based on the Object Oriented Dynamic Langua 
(OODL) Dylan. Developers will be able to produce code targeti 
both 680x0 and Power Macintosh systems 

e Automatic memory management 

e Application framework and user-interface builder 

e High-level exception handling 

e Cross-language support for C code and APIs 


CD & Online Documentation Our Price $39.95 (SADTRO 
CD & Hardcopy Our Price $59.95 (SADTRH) 


1-800-MACDEV-1 © Outside U.S. & Canada 805-494-9797 © Fax: 805-494-9798 
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e Includes improved JAVA support, an aloha versiol 
books, extensive reference material and Apple Guide © 


e Two free updates and technical support included with regis. 


Our Price $399 (SCWGOLD) 
SEE RELATED PRODUCTS: @ Code Manager ¢ Inside Power Plant ¢ Inside v 


° C++ Programming with CodeWarrior ¢ PowerMac Programming Starter Kit ; 


CodeManager 
by Metrowerks 


e Source code control system, plug-in to the CodeWarrior IDE 

e Compatible with Microsoft Visual SourceSafe version 4.0a 

e Cross-platform support (Mac, Windows, UNIX, OS/2) 

e Configuration management in excess of 4 billion files 

e Over 8,000 files and sub-projects in a single sub-project 

e Registered users receive one year of free technical support 
and two free updates 

e Includes a 1-year MacTech subscription. 


Our Price $399 (SCDMGR) 


Discover Programming for Macintosh 
by Metrowerks 


e Includes full version of CodeWarrior along with three online 
tutorial books and Dave Mark’s “Learn C on the Macintosh” 
converted to AppleGuides 

e Includes C, C++ and Object Pascal compilers for generating 
68K Macintosh code, source-level debuggers, object-oriented 
frameworks (PowerPlant, MacApp), Apple’s MPW, complete 
online documentation and source code examples for all 
languages and platforms 

e The IDE software has been localized in eight languages plus 
English. This product is not sold as a subscription 

e Includes a 3 month subscription to MacTech Magazine 


Our Price $79 (SCWDISCMAC) 
SEE RELATED CATEGORY: Dev. Environments 





Programming for Macintosh ¢ Learn C on the Macintosh ¢ Metrowerks CodeWar. 





CodeWarrior for BeOS DR2 


by Metrowerks 


e Start programming for the new, innovative Be Operating System 
(BeOS) with complete set of Codewarrior tools 

e BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

e A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

e BeOS header and libraries, complete documentation, useful 
C++ classes, and sample code 

e The Be Operating System DR8.2 for Power Macintosh allows 
you to run and program for the BeOS on a 603 or 604 PCI 
based PowerMac 


Our Price $149 scweB) 


CodeWarrior Wear (xi only) 

You live it, you breath it... you might as well wear it! 
e Black CodeWarrior Sweatshirt: 

Our Price $29.95 (Acwswear) 

e “Blood, Sweat & Code” black short-sleeve shirt: 
Our Price $9.95 (acwssLoop) 

e Hawaii Five-O shirt: 

Our Price $7.95 (AcWHAWAI) 

° Hat: Our Price $14.95 

Please Specify: Black (ACWBHAT) or White (ACWWBHAT) 
e Winter Hat (see Web site) 

Our Price $14.95 (AWINHAT) 
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support for Scripting, Powerful Standard 
Libraries which includes I/O Streams, ANSI standard C library, and 


e Full source code is included — Create applications that run on 


68K Macs and Power Macs (emulated) 


e These applications can easily be migrated to native Power Mac, 


by trading up to Symantec C++ for Power Mac 
List $299 Our Price $99 (SsymcPPésk) 


FORTRAN 90 for Power Macintosh 
by Absoft Corporation 


Absoft F90 SDK is a complete native ANSI FORTRAN 90 

development kit for Power Macintosh. Includes a globally 

optimizing compiler (includes 604 optimizer). 

¢ Graphical debugger, browsers, array display, performance 
profiler, linker, MRWE application mainframe 

e MIG graphics library, Absoft Create Make, several utilities, 
the latest version of MPW and illustrated documentation 

e Whole array operations, modules, interface blocks, and 
user-defined types or data structures 

e Dynamic memory allocation and new control constructs 

e F90 is link compatible with Absoft F77, C++, MrC and 
CodeWarrior 

e It is fully compatible with Toolbox, MPW tools, and most 
third-party products 


Our Price $799 (SF90) 


EX appilcations, a New 

iource code debugger 

K Class Library 

‘our registration card and more 





‘ramming, Learn C++ on the 
Mastering theTHINK Class Library. 


ir MachTen—UNIX 


n Intersystems 


ically linked shared libraries, memory mapped file acce 

egrated UNIX and Macintosh development tools 

4 and conforms to the Federal Information Processing 

_ 'd 151-2 (the POSIX FIPS) 

| \ptive multitasking for UNIX applications and includes a 

_ high-performance TCP/IP protocol stack that support 

: Oming and multi-casting, features not yet available eve 

— ple’s new Open Transport 

EJiete UNIX software development environment with a 
source-level debugger and C, C++, and Fortran compilers all 
generating native PPC code 

¢ Also included is a high-performance X server and complete 
X11R5 X 


Our Price $695 (sm1opPc) 
SEE RELATED CATEGORY: Internet Related 


F77 SDK 
by Absoft Corporation 


For Power Macintosh includes a globally optimizing native 
compiler and linker, native Fx™ multi-language debugger, and 
Apple's MPW development environment, 


e The compiler is a full ANSIISO FORTRAN 77 implementation 

e Includes all MIL-STD 1753 extensions, Cray/Sun-style 
POINTER, and several FORTRAN 90 enhancements 

e MRWE, Absoft’s framework library is included in the MIG 
graphic library 

¢ Supports the native Macintosh PPC toolbox 

e Includes Absoft’s Fx debugger which can debug intermixed 
FORTRAN 77, C, C++, and PPC assembler 

e The linker compiler, and debugger all run as native PPC 
tools, and produce Macintosh PPC executables 


Our Price $699 (SF77) 


1-800-MACDEV-1 © Outside U.S. & Canada 805-494-9797 © Fax: 805-494-9798 


NS BASIC 3.5 for the Newton with Visual Designer 





by NS BASIC Corporation 


e A fully interactive implementation of the BASIC programming language 

e Runs entirely on the Newton — no host is required 

e Create files, access the built-in soups, and the serial port for input and output 

e Work directly on the Newton, or through a connected Mac/PC and keyboard 

e Get the BASIC Internet Tool, available at no charge to NS BASIC users from 
www.nsbasic.com. Release Notes with sample code are available from the 
same location 

e Runs on any Newton MessagePad 130 with NS BASIC and the Newton Internet 
Enabler. Also runs on MP 1201s with NOS 2.0 that have full memory available 

e Write short programs to access News, mail and the web 


List $99 Our Price $94.99 (SNSBASIC) 


lachten Code Builder 
Tenon Intersystems 


acintosh Software Development Tool Suite for Building Mac, 
IIX, and X Applications. 

JNIX and Mac development tools 

AfterStep (NexT-style) X Window desktop 

C/C++, Objective-C, Java, Ada95, Fortran77 

Mac Toolbox (SDK) bindings to produce native Mac apps 
Perl, MacPerl, tcl/tk, expect, bash, csh, sh, alpha, BBEdit 
Lite, emacs, sample apps 


Introductory Our Price $99 (SiM10CODEB) 


ersonal MachTen for 68K Macs 

' Tenon Intersystems 

MachTen UNIX for Macintosh (from Classic on up, including 
PowerBooks and Duos) 

A Mach-based Berkeley UNIX with pre-emptive multi-tasking 
Extends the Mac OS with UNIX networking and software 
development tools 

Built-in internet services include domain name service, POP 
mail service, internet routing, SLIP & PPP, and Web service 


Our Price $495 (Sm10PER) 
Also Available: MachTen XWindows 


Our Price $350 (SMACHY) 
SEE RELATED CATEGORY: Internet Related 







fax, or E-mail us. 


PRODUCT 

LPA MacProlog Developers Edition 
LPA MacProlog Programmers Edition 
LS FORTRAN 

Mac FORTRAN II 

Professional MachTen for 68k Macs 





_Here’s a list of all available products. 
For full product descriptions please see our Web site, or feel free to call, 





CODE 
SLPAD 
SLPAP 
SLSFORT 
SFORT2 
SPROM10 


Presenting Magic Cap, 

A Guide to General Magic’s 
Revolutionary Communicator 
Software 


by Barbara Knaster 


e Perfect for novices as well as experts who want to take 
full advantage of Magic Cap 

e Step through its screens, see how it works, and learn 
ways to use it 

e Describes the power of smart messaging to customize the 
way you handle e- mail, a name card file that learns how 
to keep track of your contacts, a datebook that performs 
like a faithful assistant, and countless other abilities 


List $16.95 Our Price $15.25 (BPRESMAGIC) 


Think Pascal Version 4.0 
by Symantec Corporation 


e Great for professionals and students 

e Fully integrated for rapid turnaround time — take advantage 
of System 7 capabilities 

e Supports large projects, enhanced THINK Class Library, 
system 7 compatibility, superior code generation, and 
smart linking 

e Includes four Macintosh disks, a user manual, and an 
object-oriented programming manual 


Our Price $165 (SPASCAL) 









LIST PRICE OUR PRICE 
1500.00 995.00 
745.00 495.00 
695.00 995.00 
995.00 949.00 
695.00 695.00 














Web site: http://www.devdepot.com ® E-mail: orders®devdepot.com 
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PowerBuilder Desktop for Mac 
by Powersoft 


¢ Client/Server & Internet Development Tool 

e Increases productivity for individual developers 

e Point-and-click DataWindow 

e Fast complied code, ODBC connectivity to desktop databases 
e Anywhere DBMS, create powerful Win, Mac, and Internet apps 


Our Price $295 (SPBDEM) 





ObjectSet Mail SDK for Macintosh 


by Smartcode Software 


' e Provides easy-to-use MIME, SMTP & POP3 APIs 

hail ol ¢ Royalty-free C++ classes for 68k and Power Macintosh 
¢ Compatible with ALL leading e-mail products 

e Ideal for use in Internet and Intranet environments 

e Samples with documented, reusable source code 

e Windows, UNIX, and multi-platform versions available 


Our price $495. (sosmspk) OOFILE Reporter Writer 
by A.D. Software 


e Full embedded report-writer, allows yot 
to preview page-by-page and either 
Symantec Visual Cafe print or save as plain text, HTML or RTI 
by Symantec Corporation ¢ Multiple levels of breaks, database 
views, headers and footers are provide 
using a clean object-oriented design 
e Incudes RAM-based version of OOFILE 
database. Included in full OOFILE 
Platform Bundle 
e Saving to file without preview of printin 





symantec Visual Café for Macintosh or Windows gives 
developers the fastest, most productive visual programming 
environment ever for creating Java applets and applications 
e Drag and drop visual programming, easy to learn and use 
e Flexible development environment, two-way programming 
¢ Comprehensive component library, create re-usable 


) 





i somites is Cross-platform-run on your 
nae, eee | Mac/Win/Unix server and creates 
ro e Extensive Java toolset and the fastest compilers web pages 

\ Our Price $199 (svcaremac) ¢ Price includes 1-year subscription 
' OR Our Price $199 (svcarewin) Our Price $500 (soorw) 


a_i 


Roaster Subscription 
By Natural Intelligence Inc. Get the most out of 
Sun’s new Java™ Programming Language! 


e Write, test and run Java applets on the Macintosh in a 
full-featured Mac development environment 

e Features include: project window that includes a finder-like view of 
packages, Macintosh native compiler, source code 
editor with powerful search features and intuitive use interface, 

Roaster runtime engine for quick and easy applet testing 

By Natural Intelligence Inc. e Requirements: PowerPC based Macintosh, CD-ROM 

e Price includes the current DR 2 release and the next two 
non-developer releases 


List $399 Our Price $299 (SROAST) 
SEE RELATED CATEGORY: Dev. Environments 





RNET RELAT} 
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e Price includes the current DR 2 release 
and the first non-developer release 


List $179 Our Price $129 (sroast1) 


wn 
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FaceSpan v2.1 
by Digital Technology International 


© Develop integrated software, make stand alone applications, create friendly interfaces 
Develop quick prototypes, print multiple pages with sophisticated layouts 

e Script essential elements of the FaceSpan application - Enhanced save options 

e Play and record sounds as either “snd” resources or as “AIFF” files 

e Create miniature or complete apps that run on either Power PC or 68k computers 

e Use precise time measurement for implementing timed behaviors - New properties 

e Proportionally scale PICT images -Align images in a pictbox -Automate any application 
e Monitor and respond to low-memory situations-Increased support for Frontier UserTalk! 


List $299 Our Price $279 (SFACESPAN) 





script Debugger 

yy Late Night Software Ltd. 

» A powerful and flexible AppleScript authoring tool — get the most from Applescript! 

» Advanced debugging environment offers single-step script execution with breakpoints 

» Script Deb igger dictionary browser features a graphical view of objects provided by 
scriptable applications 

» Includes Late Night Software Scripting Additions — a collection of more than 70 new 
AppleScript commands, and Scheduler, a utility that allows you to launch scripts at 
pre-determined times 


List $129 Our Price $119 (svEBUG) 










Scripter 2.0 pmmmn 9 | TOP AP 
by Main Event Software ° | Scripting Addition 
For professionals, for novices, for web- e@eeee by Mango Tree Software 
masters, for solutions providers, there's e Award-winning AppleScript 
only one serious choice. Scripter! scripting addition 


e Scripter and FaceSpan work together: e Allows you to write scripts 
one click opens your FaceSpan script 2 : using MacTCP™ commands 
in Scripter, another sends it back in AppleScript™ 

e Debug handlers without modifying your scripts using the Call Box 

e Applet sinulation, live editing, Object map, associated terminology 

e Search tackwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

e ScriptBase is now included; stores your data and media elements 
(frequently used values, text, pictures, scripts, HTML, headers, file 
references) and share them between scripts all with a special 
new browser 

e Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

e Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without it! 


List $199 Our Price $179 (SSCRIPTER) 


The internet Scripting Solution 





e Send e-mail or files through a script, check if users are 
logged on (via Finger), automate FTP, Gopher, NetNews, 
Telnet, and LPR, verify links in HTML documents, and quickly 
write many other TCP/IP client-server programs 

e Works with AppleScript, MacTCP 2.0.4 and Open Transport 


Our Price $49 (stcp) SEE RELATED CATEGORY: Scripting 
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Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT CODE LIST PRICE OUR PRICE 
CodeWarrior Discover Java SCWDISCJAVA $99.00 $79.00 


DogPatch SDOGPATCH 299.00 199.00 
PreFab Player SPLAYER 95.00 95.00 
ScriptBase SSCPTBASE 59.00 59.00 
ScriptWizard SWIZ 89.00 84.95 
SmallTalkAgents SSTRA 695.00 695.00 
Tenon Ported Applications CD SPORTED 50.00 49.95 


Web site: hito://www.devdepot.com ¢ E-mail: orders@devdepot.com 





BBEdit 4.0 


by Bare Bones Software 


e A powerful, easy-to-learn text editor 

e Adds new features for HTML coders, including a spelling 
checker and HTML tag palette 

e Accelerated for Power Macintosh; dragging supported everywhere; 
Internet Config aware; PowerTalk aware 

e Integrated support for Symantec’s IDE, Metrowerks CodeWarrior, THINK 
Reference 2.x, MPW ToolServer, and most other environments 

e Many UNIX style tools, including “grep” searches, file comparisons, and sorting 
multi-file search and replace 

e PopUpFuncs feature lets you jump to a function from a menu 


List $119 Our price $94 (sBBEDIT) SEE RELATED CATEGORY: Internet Related 






QUED/M 3.0 


by Nisus Software 


e The programmer's text editor that defined the industry standard for speed and efficiency 

e PowerPC native 

e Features integrated support for Symantec C/C++, Metrowerks CodeWarrior 6, and MPW 

© Supports all the major development environments on the Macintosh. 

e Powerful editing features, including unlimited undo and redo, macro language, scripting, text 
folding, ten editable/appendable clipboards, markers, displaying text as ASCII codes, dynamic 
coloring of C/C++ keywords/comments, rectangular and non-contiguous selection 

¢ Includes Celestin Company's APPRENTICE 4 


List $149 Our Price $89 (squepw) 





Movie Cleaner Pro 1.3 
by Terran Interactive 


¢ Compress QuickTime movies 

¢ Powerful and easy-to-use, great for both beginners and experts 

e Includes: drag and drop batch processing, suspend and resume, adaptive noise re 
duction, IMA audio compression, high quality crop and resize, A/V fades, gamma 
correction and de-interlacing 

¢ Automatically suggests the best settings for your application. 

e Great for both beginners and experts 

e Essential for CD-ROMs or Web sites 


Our Price $189.95 (smovie) 
SEE RELATED PRODUCTS: Quick Time Official Guide 








Bee-one OpenGL for the Macintosh 
by Power Box by Conix Graphics 


Bee-one lightens your load on the road by © Powerful 3D graphics library, 100% OpenGl compliant 
adapting relational databases developed e Portable to more platforms than any other API 
under 4D° to the Newton Platform. Once ¢ Delivers workstation-class performance to the Mac 
the program is installed on both the e RAVE hardware support gives you the speed you need 
Macintosh and the Newton, it takes 4 ¢ Multi-processor capability & works with ALL compilers 
simple steps to use Bee-one! Our Price $279 (SoPENGL) 
e Database transfer, Set-up, Use, and 

synchronization 


Our Price $139 (sBecone) 


1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 








Legtop Podeum 
by Rach Inc. 


A combination working 
platform and carrying case 
that allows laptop owners a 
safe and comfortable way to 
use their computer in a variety 
of mobile and field environments. 


Our Price $79.95 (aLetPPop) 


CronManager 
by Orchard Software 


e Implements the UNIX Cron facility 

e Open any Macintosh file on a given date and time 
e Simple interface 

e Works with any Macintosh file 

e Cron Manager bundled with CLimate 


Our price $26.95 (ScRONMGR) 


CPU Doubler 
by Orchard Software 


e Performance enhancement 
utility for the Macintosh 

e Increases the speed of 
your computer by 100% 

e Works on both the PowerPC 
and 68K Macintosh 

e Manages computer 
throughput using a proprietary scheduling algorithm 

e Ensure optimal performance and compatibility 


Our Price $79.95 (scPu2x) 


Doubling Options 
©) Best Performance 

©) Better Performance 
(©) Good Performance 


@ Custom Performance 


Edit Processes... 


Special Settings 


Exclude Files... 


CJ Exclude Background-Only | at startup 
(1 Exclude Finder to abort 


NeoAccess 
by Neologic 


e Full-featured object database engine for use in Macintosh, 
Windows, Unix and DOS based C++ applications 

e Extended binary trees and binary search algorithms tuned for 
short access times; dynamically combined, collapsed, and 
compressed indices; object caching for instant access to 
previously used objects 

e Build fast, powerful applications in record time! 


Our price $749 (sneo) 








c-tree Plus® Database Handler 
by Faircom 


Unsurpassed Cross 
Platform Tools for Mac 
Developers! 


e Full C Source 

@ Client/Server Option 

e Over 16 years 
proven reliability 

e Concurrent simultaneous access of Mac/PC files 

e Superior throughput and performance 

e Unparalleled scalability and flexibility 

e Fixed/Variable length files 


Our price $895 (scTPDH) 


r-tree Report Generator 
by Faircom 


Handles virtually every aspect of report generation: 


e Complete C source 

e Complex multi-line reports 
e Multi-file access 

e Complete layout control 

e Conditional page breaks 

e Nested Headers and Footers 
e Horizontal Repeats 


Our price $445 (sATRG) 


Guide Composer” 1.2 
by StepUp Software 


e Create powerful Apple Guide help systems for any new or 
existing Macintosh application 

e Provides a WYSIWYG development environment: Guide content 
is developed in Guide windows 

e Design topics, phrases, and panels in the same format as the 
user will use them 

e Features are WYSIWYG interface, Topics, phrases, and 
hierarchical phrases, Coach marks, Fully-Integrated with 
Apple’s Guide Maker (distributed with Guide Composer), 
compiles scripts automatically, PICTs in Panels, Generated 
Guide scripts are modifiable 

e FREE Update to all registered Guide Composer users. Demo is 
available at http://www.guideworks.com/ 


Our Price $99 (sccomp) 


SFE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppleGuide Starter Kit, Real World AppleGuide 





Web site: htto://www.devdepot.com ® E-mail: orders®@devdepot.com 
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Memory Mine 
by Adianta Inc. 


e Monitor heaps, identify problems such as memory leaks, 
and stress test applications 

e Active status of memory in a heap is sampled on the fly: 
allocation in non-relocatable (Ptr), relocatable (Handle) and 
free space is shown, as are heap corruption, fragmentation, 
and more 

e Allocate, Purge, Compact, and Zap memory lets users 
stress test all or part of a program 


List $99 Our Price $94.99 (SMEMMINE) 
SEE RELATED CATEGORY: Dev. Environments 





vooDOo0 
by UniSoftware Plus 


e Version control tool for the simple and clear management of 
projects in which files 
are created In numerous versions (variants and revisions) 

e Allows both variant and revision control, and it manages not only 
variants and revsions of single files, but of a whole software pro- 
ject (multi files, multi users, multi-variants, access rights, etc.) 

e Graphical user interface and is not only suitable for mere source 
code control but can handle all different kinds of files with amazing 
compression rates: typical size of delta between arbitrary files 5% 

e Please note special prices for multiple copies: | 


Single license $229 (svoon001); 2 pack $359 (svoopo02): 
5 pack $799 (svoop005); 10 pack $1369 (svoop0010); 


20 pack $2399 (svoon0020) 


Additional pricing available on request. 
SEE RELATED CATEGORY: Dev. Environments 


StoneTable 68K/PPC 
by StoneTablet Publishing 


e Stonelable is a replacement for the Macintosh List Manager 

e Available for use with Think C, MPW C & Pascal, CodeWarrior C 
and Pascal 

e Includes libraries for 68K and PowerPC 

e An LTable-like class is provided to incorporate StoneTable into 
the PowerPlant environment 


Our price $200 (SSTONEFAT) 
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Clip VR" 


by eVox Productions 


Clip VR™ is a new digital image library offering high quality 
Photographic Virtual Reality (PVR) images for use with Quicktim 
VR and other desktop VR tools. 


e Clip VR™ Panoramic Image components include alpha channel ma 

e Combine elements into a composite panorama which is conver 
to the finished QuickTime VR movie using Make QTVR Panorama T 

e The Components (“Clips") include complete 360 degree scen 
libraries of 360 degree terrains, 360 degree skies, buildings, 
and objects 

e |mages are provided as .PICT files AND QuickTime VR movie fi 

e Clip VR™ allows you to create high quality VR worlds from 
pre-photographed component images 

e Clip VR™ can be used to add excitement to a web site, to 
increase the interactive value of a CD-ROM, or simply for fun! 

e Requires imaging editing program such as Adobe Photoshop” 
to perform .PICT image compositing 


Our price $89.95 (SCLIPvR) 


Qc 


by Onyx Technology 


High performance runtime stress testing for applications. 

e ests include heap checks, purges, scrambles, handle/pointer 
validation, dispose/release checks, write to zero, de-reference 
zero as well as other tests like free memory invalidation and 
block bounds checking 

e Extremely user friendly — ideal for non-programmer testers 

e Also available in Japanese 


List $99 Our price $94.99 (sac) 


1-800-MACDEV-1 ¢ Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 





tPolish CD-ROM 


are Bones Software 


> essential tool for software quality assurance on the Macintosh 

ps you identify inconsistencies with Apple’s user interface 

idelines, misspelled words, missing resources, and other mistakes 
vides tools to put the finishing touches on software distribution 
ckages prior to release 

rks independently of any programming language or environment 
‘al for sanity checking software throughout the development process 


st price $99 Our price $89 (ssoFTPoL) 


yer 

1Cider 

sy to use tool that records all actions (including mouse 
ovement) you perform on a Macintosh computer and then 
plays them at your preferred speed 

corded data can be saved in files for future use 

orks as a background process with any Macintosh 
plication and is triggered by user defined Hot Keys 

lables the “Continuous Redo” utility and is especially useful 
r software testing and demonstration 


Jr price $39 (SSPY) 


dt . by dtF Americas 





ue relational database system for Apple Macintosh computers 
‘ovides a powerful choice for developers who want to create 
jtabase centered applications with no performance trade-offs 
2atures SQL, full transaction control, error recovery, single user, 
ient server architecture and multi-platform support including 
OS, Windows, 0S/2 and UNIX 

Ye C/C++ API is identical and fully portable across all 

Jpported platforms 

nird-party vendors supporting dtF will be able to offer a 

ariety of advanced features and benefits to their customers 
yyalty free 

dols are included for importing, exporting, creating and managing 
atabases and users 

upported development environments include: Symantec, MPW, 
Metrowerks and more Mac/SDK 


ist $695 Our Price $679 (sptF 


Future Basic Il 
by Staz Software 


FutureBASIC Il is the award winning leader in Macintosh 
BASIC programming. 

e Source level debugger and Interactive compiler/editor 

e Multi-file Project manager and Multi-file find and replace 
e Super fast compilation, 32 bit clean, and System 7.x savvy 
@ QuickBASIC converter 

e Getting Started manual with over 500 example files 

e Full support of standard BASIC 


Our price $229 (sFBAsic2) 


PowerTap 


by Fortner Research 


e Offers a simple method of implementing multi-processor 
capabilities to any application 

e Creates applications that are compatible with Apple’s DayStar 
and other multi-processing computers 

¢ Compatible with Fortran, C, and C++ programming environments 

e Adjustable slide bar controls the level of CPU-sharing. 

e Contains Thread Manager Options 

e Available now for MPW, CodeWarrior, Symantec Project Manager, 
PowerPC, Ad, and A4 


Our Price $299 (spowtap) 


Speliswell Plus 2.0.4 
by Working Software 


e Award-winning, comprehensive, practical spelling checker that 
works in batch mode or within applications that incorporate 
the Apple Events Word Services protocol (e.g., Eudora, 
WordPerfect, Communicate!, and InfoDepot) 

e Checks for spelling errors as well as common typos like 
capitalization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc. 

e MacTech orders include developer kit with Writeswell Jr., a 
sample AppleEvents Word Services word-processor and its 
source code 

e Available for OEM Sales 


Our price $74.95 (ssPELt) 


Web site: http://www.devdepot.com ® E-mail: orders@devdepot.com 








B-Tree HELPER 2.2 
by Magreeable Software 
e Inexpensive database engine for Macintosh programmers 
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in C source code 





$150 (sBrREE) 


Step-Up Installer Pack 
by StepUp Software 


e Package of several Installer “atoms” that let developers 
incorporate graphics, sounds, file compression and custom 
folder icons into installation scripts 

e Compression formats supported are Compact Pro & Diamond 

e Each atom also available separately 

e Compression requires additional licensing 


Our price $219 (sSINSTALL) 





e Uses contiguous fixed length blocks 

e Expands the file as necessary and contracts files when possible 

e Inserts and deletes keys in one or more B-Trees 

e Finds keys equal to, less than, or greater than a given value in 
a few hundredths of a second 

e Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values Our Price 








ScriptGen Pro 
by StepUp Software 


e |nstaller script generator which requires no programming 
or knowledge of Rez 

e Supports StepUp’s InstallerPack, Stufflt decompression, 
Compact Pro decompression, custom packages, splash 
screens, network installs, and resource installation 


Our price $1 69 (SSCRPTGEN) 
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e Tracks bugs, feature requests, test configurations, users, 
and more 

e Includes notifications, security, a powerful filter 
mechanism, and multiple reports 

e Links your testers, engineers, documentations staff, 
and project managers together to ensure all bugs are 
identified, fixed, and documented 

e Eliminates the need to build custom bug tracking 
solutions using general purpose database tools 

e Supports single- and multi-user bug databases (additional 
licenses required to use multi-user features) 


Our price $129 (steTR 


the original interface builder 

e Just point and click to design your application 

e Creates resources and generates excellent source code 

e Supports most development environments including 
Metrowerks, Symantec, or MPW; C, C++, or Pascal; procedt 
or object-oriented, using PowerPlant, TCL, or MacApp 

e The generated code uses the Universal Headers to provide 
PowerMac compatibility 

e Great tool for beginners to learn object-oriented and 
Macintosh Toolbox programming techniques 

e Includes one-year subscription on CD and hardcopy 
documentation 


List $299 Our Price $199 (SAPPMAKE) 


1-800-MACDEV-1 ¢ Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 













PRODUCT 

3D Game Machine 

AdLib 

Animation Class Library 
CLimate 

CMaster 

CometPage 

CometSite 

CometPage/Site Bundle 
DataScript 

ICONIX PowerTools-10 Pack 
ICONIX PowerTools-6 Pack 
ICONIX PowerTools-8 Pack 
ICONIX PowerTools-AdaFlow 
ICONIX PowerTools-ASCIl Bridge 
ICONIX PowerTools-CoCoPro 
ICONIX PowerTools-DataModeler 
ICONIX PowerTools-FastTask 
ICONIX PowerTools-FreeFlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerTools-QuickChart 
ICONIX PowerTools-SmartChart 
ICONIX Training & Consulting 
IMSL Math and Stat F77 
Info-Mac X 

LJ Profiler 

Mac Games III 

Mac Source II 

MacA&D Demo 

MacA&D Product 

MacAnalyst Product 

Macintosh Common LISP 4.0 
MacDesigner Product 
MacsScholar 

MacScholar ur. 

MacWireFrame 

MAScript 

More Savvy 

PowerBuilder Desktop for Mac 
PowerMac 2 

PreFab Player 

Professional MachTen for 68k Macs 
Rosanne 

S-Case 

Savy 

Savy QuickTime 

stone Table 68K/PPC 

super Savvy 

superPlot 

superPlot Pro 

Tenon’s NEW! MachTen Code Builder 
Tenon Ported Applications CD 
Top 10 Pick for Macintosh 
V3d/3dPane/SmartPane 

VText 


CODE 
SSDGAME 
SADLIB 

SACL 
SCLIMATE 
SCMASTER 
SCMTPG 
SCMITST 
SCMTPSB 
SWDSCRIPT 
SICPP10 
SICPP6 
SICPP8 
SICADA 
SICASCI| 
SICCOCO 
SICDATAMOD 
SICFASTTASK 
SICFREEFL 
SICOBJMOD 
SICPOWER 
SICQUICKCH 
SICSMART 
TICONIX 
SIMSLSTAT 
SINFOMAC10 
SLUPROF 
SMACGAMES3 
SMACSOURCE 
SMACADD 
SMACADP 
SMACANP 
SMCLISP 
SMACDESP 
SMACSCHOL 
SMACSCHOLJR 
SFRAM 
SMASCRIPT 
SMORSAV 
SPBDFM 
SPOWERMAC2 
SPLAYER 
SPROM10 
SROSANNE 
SSCASE 
SSAWY 
SSAWYQT 
SSTONEFAT 
SOSAWY 
SOPLOT 
SSPLOTPRO 
SM10CODEB 
SPORTED 
STOP10PICK 
SQ3 

SVTEXT 


LIST PRICE 


$299.00 
195.00 
290.00 
09.95 
129.95 
149.00 
149.00 
249.00 
249.00 
(990.00 
9,995.00 
6,995.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
3,000.00 
495.00 
39.95 
295.00 
29.95 
29.95 
149.00 
2,995.00 
995.00 
7295.00 
995.00 
29.99 
29.9) 
299.00 
199.00 
450.00 
295.00 
29.95 
95.00 
695.00 
099.00 
495.00 
290.00 


290.00 - 


200.00 
700.00 
195.00 
349.00 


Limited Offer 


90.00 
49.95 
192.00 
350.00 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


OUR PRICE 


$299.00 
195.00 
250.00 
99.95 
129.95 
149.00 
149.00 
249.00 
229.99 
7,845.00 
9,945.00 
6,945.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
2,945.00 
495.00 
35.95 
295.00 
26.95 
26.95 
75.00 
1,995.00 
995.00 
725.00 
945.00 
26.95 
26.95 
75.00 
195.00 
445.00 
295.00 
26.95 
95.00 
695.00 
995.00 
395.00 
245.00 
245.00 
200.00 
695.00 
145.00 
349.00 
99.00 
49.95 
44.95 
192.00 
350.00 


Web site: http://www.devdepot.com ¢® E-mail: orders@devdepot.com 
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Inside Macintosh: CD-ROM 


by Apple Computer, Inc. 
e More than 25 volumes in electronic form 
e Includes: QuickDraw™ GX Library, Macintosh Human Interface 


_ = INSIDE MACINTOSH 


CD-ROM _ 
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‘5 Here are all of the Inside Macintosh products — 10 % off! For full product 
s . descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


There 












Guidelines, PowerPC System Software, Macintosh Toolbox Essentials 
and More Macintosh Toolbox, QuickTime and QuickTime Components 


e Access over 16,000 pages of information with Hypertext linking and 


ere? 9Uq - 







extensive cross referencing eS %, 
List $99.95 Our Price $89.95 imco) 2 % 
Feel ° 
ape 
2 urc . 
zP os 
% ° 
¥ reture © 


(Book sale prices are contingent upon availability) 


more*/ 

PRODUCT CODE LIST PRICE OUR PRICE 
Inside Macintosh: AOCE Applications Interface BIMAOCE $44.95 $40.45 
2 Inside Macintosh: AOCE Service Module BIMAOCES 29.95 26.95 
| q Inside Macintosh: Devices BIMDEV 29.90 26.95 
— Ch Inside Macintosh: Files BIMFIL 29.95 26.95 
7 \ 4 Inside Macintosh: Imaging with QuickDraw BIMIMAG 32.95 29.65 
hens | | Inside Macintosh: Interapplication Communications — BIMIAPP 36.95 33.25 
Zz | ‘ Inside Macintosh: Macintosh Toolbox Essentials BIMTBOX 39.95 35.95 
z=! Inside Macintosh: Memory BIMMEM 24.95 22.45 
| Inside Macintosh: More Macintosh Toolbox BIMMAC 34.95 31.45 
= Inside Macintosh: Networking BIMNET 29.95 26.95 
ae | ' Inside Macintosh: Operating System Utilities BIMOPSU 28.95 26.05 
eal > | Inside Macintosh: Overview BIMOVER 24.95 22.45 
wt | Inside Macintosh: PowerPC Numerics BIMPPCNUM 28.95 26.05 
oe | Inside Macintosh: PowerPC System Software BIMPPCSYS 24.95 22.45 
ee \ i Inside Macintosh: Processes BIMPROCG 22.95 20.65 
fin \ : Inside Macintosh: QuickDraw GX Environ. & Utilities — BIMGXENV 31.95 28.75 
El | Inside Macintosh: QuickDraw GX Graphics BIMGXGR O10 28.75 
&, | | Inside Macintosh: QuickDraw GX Objects BIMGXOBJ 31.95 28.75 
ott | Inside Macintosh: QuickDraw GX Printing BIMGXPRNT 29.95 26.95 
~~ | Inside Macintosh: QuickDraw GX Printing Extensions = BIMGXEXT 29.95 26.95 
ip. Inside Macintosh: QuickDraw GX Prog. Overview BIMGXOV 24.95 22.45 
WA | Inside Macintosh: QuickDraw GX Typography BIMGXTYP 29.95 26.95 
a | Inside Macintosh: QuickTime BIMOT 29.95 26.95 
mx. : Inside Macintosh: QuickTime Components BIMQTCOM 34.95 31.45 
>< : Inside Macintosh: Sound BIMSOUND 29.95 26.95 
ae Inside Macintosh: Text BIMTEXT 39.95 35.95 
' —— Bl Inside Macintosh: X-Reference BIMXREF 19.95 17.95 


1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 ¢ Fax: 805-494-9798 





eee §=§=©6Programmer’s Toolbox Assistant CD-ROM 
xr A A 1. Instant electronic access to Inside Macintosh essentials. 

] | | 4 by Addison-Wesley Publishing 
| be Vv me e Get quick access to reference pages for over 4,000 Toolbox calls in 

| your system software from their development environment 

e Essential information for Macintosh software developers 

e Hypertext links allow programmers to view related topics easily 

e The ultimate electronic reference tool for Macintosh programmers 


List $99.95 Our Price (STBASST) 
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@ by Apple Computer 





AppleScript Applications: Building 
Applications with FaceSpan and 


AppleScript 


by John Schettino Affiliation & Liz O’Hara 

e Build complete AppleScript applications using FaceSpan, a user 
interface development tool that makes AppleScript applications 
truly “Mac-Like”. Uses @ step-by step approach to demonstrate 
techniques for building applications through illustrations and 
samples. Provides Graphical User Interface (GUI) design tips 
and practical approaches for implementation 

e Contains one CD-Rom wth AppleScript 1.1, a demonstrations 
version of FaceSpan 2.1, source code for all example applications 





numerous AppleScript shareware and demonstrations programs The Elements of E-Mail Style 
e Contains a section on desugging AppleScript applications using by Brent Heslop and David Angell 
FaceSpan ¢ Write solid, effective E-Mail and 
List $34.95 Our Price (BAPSCAP) avoid common pitfalls 
List $14.95 Our Price (BEMAIL) 


Hooked on Java 
by Arthur Van Hoff, Sami Shaio, and Orca Starbuck 


e Written by the Java development team at Sun Microsystems, Inc. 

e An introduction to using applets, for Web administrators, designers, 
and developers 

e Demonstrates how to use applets in your own pages 

e Includes a concise introduction 
to the Java language, and a CD with tools 


List $29.95 Our Price (BHJAVA) 





Java in a Nutshell 
by David Flanagan 


e A complete quick reference guide to Java, the hot new programming 
language from SunMicrosystems 

e Contains descriptions of all of the classes in the Java 1.0 API, with a 
definitive listing of all methods and variables 

e Also contains an accelereted introduction to Java for C and C++ 
programmers who want to learn the language fast 


List $14.95 Our price (BUAVANUT) 





Web site: http://www.devdepot.com ¢ E-mail: orders@devdepot.com 








Planning and 


Managing Websites 
by Jon Weiderspan and Chuck Shotton 


e The definitive guide to setting up and running a Web site on the Macintosh 

e Learn everything you need to know about using WebSTAR, the best 
known HTTP server software and its shareware predecessor MacHTTP 

e Write CGI applications for your server — in AppleScript and in C 

e CD includes a special version of WebSTAR, plus tons of useful software 





List $39.95 Our Price (BPLANWEB) 
Teach Yourself Java for JavaScript for the 
Macintosh in 21 Days Macintosh 





by Laura Lemay and Charles L. Perkins by Matt Shobe and Tim Ritchey 





— with Timothy Webster e Allows non-programmers to take advan- hehe dpa 
JA VA e Add interactivity and multimedia to Web tage of the power of Netscape Navigator 
sn wan Das pages! e Expand the capabilities of your Web page, 
e A step-by-step guide 7o make your Web without having to understand C or C++ 
site come alive e CD-ROM contains “Wizlets” that allows you 
e Learn the basics of programming Java to easily create your own Javascripts 
applets and the concepts behind the Java e Jakes you step-by-step through programming 
language cross-platform Javascripts 
r~% e Includes CD-ROM with a limited version of ¢ Details how to create Javascripts for Javascript-aware 
Roaster, the first commercial, integrated Web browsers 
applet development environment for Java List $45 Our price (BJAVASCRPTU) 
\ for the Macintosh! 
\ , List $40 Our price (BJAVAMAC) 
Mac OS & Revealed 


by Tony Francis 


e The first authoritative look at this exciting new operating system 

e A must for Mac developers who want to make their software 
compatible with Mac OS 8 

e Essential for system administrators who plan to upgrade their system 

e Included CD-ROM contains demos of new Mac OS 8 features 


List: $34.95 Our Price: (BVIACOS8R) 





Here are some popular books for the NEXTSTEP enthusiast - 10% off! 
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PRODUCT CODE LIST PRICE 
NEXTSTEP Development Tools & Techniques BNEXTDTT $30.95 
NEXTSTEP General Reference BNEXTGR 44,95 
NEXTSTEP Operating System Software BNEXTTOSS 28.95 
NEXTSTEP Programming Interface Summary BNEXTPIS 30.95 
NEXTSTEP User Interface Guidelines BNEXTUIG 24.95 


1-800-MACDEV-1 ¢ Outside U.S. & Canada: 805-494-9797 ¢ Fax: 805-494-9798 











arn C on The Macintosh 


cond Edition 
lave Mark 


‘w revised edition! 

sy-to-understand — everything you need to start programming 
\dated and enhanced exercises that lead you step by step. 
u'll learn function, variables, pointers datatypes, data 

‘uctures, file input and outout and more! 

sludes CD-ROM with Metrowerks CodeWarrior™ Lite — the 

ttest Macintosh programming environment (including a PowerPC 
sion) 

st $34.95 Our Price $31.45 (BLEARNC2) 

-E RELATED CATEGORY: Dev. Environments 





itimizing PowerPC Code: Programming 


2 PowerPC in Assembly Language 
gary Kacmarcik 


ike full advantage of the potential of the PowerPC by mastering 
ie Assembly Language techniques 
earn to produce faster more robust software! 


ist $39.95 Our Price $35.96 optprc) 


il By Example 

Jeffrey Dwight 

2D-ROM contains all the code and tools used in the book, and 
idditional tools and examples, as well as related chapters from 
special Edition Using CGI and Special Edition JavaScript 
ncludes end of the chapter review questions and exercises to 
einforce the learning process 

sovers basic CGI applications, as well as advanced topics like 
server administration issues and database connectivity 


ist $34.99 Our Price $31.45 (ssciBe 





OBJECTIVE-C 


Object-Oriented Programming Techniques 
by Lewis J. Pinson and Richard S. Wiener 


This book presents the basic concepts of object-oriented 

design and programming, and provides a precise description of 

the Objective-C language. Several small- to medium-sized 

applications using Objective-C illustrate the general principles of 

object-oriented programming. 

e Covers the two main versions of the Objective-C language 

e Demonstrates the versatility and power of the NeXT machine as 
a platform to support object- oriented programming 

e Shows how to design, implement, and use hierarchies of 
classes 

e Explains the purpose of pre-defined classes and shows how 
they can be used in designing programs 


List Price $37.95 Our Price $34.15 (opucoorn 


CodeWarrior Software Development 


Using PowerPlant 
by Jan L. Harrington 


e C++ programmers will learn to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it 

e Covers CodeWarrior 8 

e Included CD-ROM contains source code for all the programming 
examples in the book and Metrowerks CodeWarrior Lite 


List Price: $34.95 Our Price: $31.45 (BCWSWDEV) 


Perl Quick Reference 
by Michael 0. Foghlu 


e Commands are sorted by task, class packet, platform or 
hardware compatability all in alphabetical order 

e Includes jump tables to guide reader to specific pages in 
the reference 

e Designed in a larger trim size than traditional Quick 
References-and with a lay-flat binding 


List $19.99 Our Price $17.99 (BPERLREF) 


Web site: http://www.devdepot.com ® E-mail: orders@devdepot.com 
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Macintosh C Programming Primer Volume | 


Second Edition, Inside the Toolbox Using THINK C 
by Dave Mark and Cartwright Reed 


e Updated new edition of the Macintosh programming best seller 
e System 7, new versions of THINK C and Reskdit 


e Learn how to use the resources, Macintosh Toolbox and interface to create 


Stand-alone applications 
e 6/2 pages 


List $26.95 Our Price $24.25 (BcpRIM1) 


Macintosh C Programming Primer Volume Il 


Mastering the Toolbox Using THINK C 
by Dave Mark 





e Covers advanced topics such as: Color QuickDraw, THINK Class Library, TextEdit, 


and the Memory Manager 
e 528 pages 


List $26.95 Our Price $24.25 (Bcprim2) 


Learn C++ on the Macintosh 
by Dave Mark 


e Basic syntax of C++ and object programming 

e Learn how to write, edit, and compile your first 
C++ programs 

e Features key C++ concepts such as derived 
classes, operator overloading, iostream func- 
tions and more 

e Includes a special version o° Symantec C++ for 
Macintosh. Book/disk package with 3.5" 800K 
Macintosh disk. 

e 400 pages 


List $38.95 Our Price $35.05 @LAncpp) 
SEE RELATED CATEGORY: Dev. Environments 





Objective-C: Object-Oriented 


Programming Techniques 
by Lewis Pinson and Richard Wiener 


e Basic Principles of Object-Oriented Problem Solving, Methods 
for Object-Oriented Design and Examples 

e Objective-C Language, Foundation Classes - Using Stepstone's 
ICpak 101 Library 

e OOP Case Studies in Objective-C, Software Development 
Environments, User Interfaces and Visual Programming 

e More Examples of Object-Oriented Problem Solving and 
Objective-C 

e Appendix A: Interface File Listings for Class Object 

e Appendix B: An Overview of Stepstone's ICpak 101 Libraries 

e Appendix C: Walk Through of an Actual Game of Las Vegas 
solitaire 


List $37.95 Our Price $34.15 @osucocen 
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Macintosh Pascal Programming Prime 


Volume | 
Inside the Toolbox Using THINK Pascal 
by Dave Mark and Cartwright Reed 


This tutorial shows programmers new to the Macintosh how to t 
the Toolbox resources, and the Macintosh interface to create sta 
alone applications with Symantec’s THINK Pascal. 544 pages. 


List $26.95 Our Price $24.25 (BPAScPR)) 


Macintosh Programming Secrets 2nd edit 
By Scott Knaster and Keith Rollin 


e Macintosh Programming Secrets is divided in two parts 

Part 1: “Concepts and Ideas” 

e Discusses the evolution of the Macintosh and the standards, 
customs, and software that shape the system as well as the 
Macintosh user interface 

Part 2: “Technical Adventures” 

e Presents the skeleton of an application, and then builds upon 
that framework to describe how to: 

e Create fancy dialogue boxes 

e Utilize the new 32 bit QuickDraw developments 

e Track the mouse with “marching ants” 

e Manage multiple windows with the Window manager 

e Copy files within a program 

e Install the worlds strangest spinning cursor 


List $31.95 Our Price $28.76 (BpsecrEn) 


1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 
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berdog Programmers Kit A Fragment of Your Imagination 

\pple Computer, Inc. by Joe Zobkiw 

ople’s official reference e Packed with useful code fragments for the Macintosh and 
must for developers who want to make customizable Internet Power Macintosh 

>cess available to all Mac users e Hard to find information about techniques used to structure and 
cluded CD-ROM contains all the tools needed to create build fat, safe fat, and accelerated code resources 
yberdog-aware components e All code is reusable and is provided on the disc, along with 

st: $39.95 Our Price: $34.95 (BcyBeRDOG) Metrowerks Code Warrior Lite 


e Book/CD-ROM, 528 pages 
List $39.95 Our Price $35.96 (FRAG) 


/ 





‘urnkey web publishing solution 
3D-ROM contains a 45 day time-limited version of NetObjects Fusion 


ist $50 Our Price $4.5 (BNETOFH) 


‘ / : | ( 

va Language API SuperBible Programming with AppleTalk r/o 
Janiel Groner, Todd Sundtsed, by Michael Pierce ame 
ey Hopson, Harish Prabandham e Programming with AppleTalk is the hands-on guide to under- te 
overs Java 1.1 Standing and working with AppleTalk - Topics include: eS, 
rovides hundreds of concrete source code examples e How to create applications and system extensions that run j ge 
ample projects introduced and assembled in each chapter with AppleTalk vee 
ist $59.99 Our price $53.99 (BuLas) e AppleTalk protocols and the protocol stack, transport media, ead 
Preferred Applelalk Intefrace, and the storage management i ail 
' | I teal 
e Numerous working code examples walk you through using RDEV, iiss 

INIT, NBP, ATP, and ADSP . =o 
e You will also learn the use of: synchronous, and asynchronous | ot 
calls,how to avoid heap fragmentation, and how to configure a i ms! 
chooser interface [= 
List $24.95 Our Price $22.45 (BpROAT) Eo pa 
pee 
Pd 
= = = = ( Revove, 
etObjects Fusion Handbook Infini-D Revealed 7. .. 
m Hayden Development Team by Brendan Donahoe & Adam Lavine > 
sreate web pages and sites through design techniques devel- e CD-ROM includes a demo version of Infini-D 3.1, files for work- s 9 
ped by Clement Mok’s design agency ing through the tutorials, and a gallery of spectacular 3D images gel 
step-by-step instructions on updating sites with links and naviga- © Shows how to use the new animation features to bring images to life J nae 
ional controls automatically e Details Infini-D’s new and improved color-coded interface “ im 
Jutlines the comprehensive steps to delivering an automated, List $45 Our price $40.50 (SINFDREV) , 
mas, 
site| 
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Web site: htto://www.devdepot.com ® E-mail: orders®@devdepot.com 








AppleScript AppleScript AppleScript 


Finde G Scriptin Additions Guide 






AppleScript Finder Guide, 


SEE RELATED CATEGORY: Scripting 


English Dialect 
by Apple Computer, Inc. 
AppleScript Language Guide e Provides definitions for Finder object classes 
by Apple Computer, Inc. and commands 
e A complete reference for anyone using AppleScript to modify e Write, record, or run scripts that trigger the 
existing scripts or to write new ones same desktop actions that you trigger using the 
e Contains useful information for programmers who are working keyboard and mouse 
on scriptable applications or complex scripts List $19.95 Our Price (BAFG) 
e Features detailed definitions of AppleScript terminology and SEE RELATED CATEGORY: Scripting 
| syntax in the following categories: Value classes, commands, 
ay objects and references to objects, expressions, control statements, 
4 handlers, and script objects AppleScript Scripting 
e Includes many sample scripts, discusses advanced topics such as “a0 . 
. _ writing command handlers for script applications, the scope of Additions Guide 
, - script variables and properties declared at different levels in a by Apple Computer, Inc. 
_ script, and inheritance and delegation among script objects e Use the standard scripting additions commands 
ee List $29.95 Our Price (BALG) Wiite ‘scripting additions 
a SEE RELATED CATEGORY: Scripting List $18.95 Our Price (BSCRADD) 
hal, 


ent 


Danny Goodman’s AppleScript Handbook, 2nd Ed. 


by Danny Goodman incledes 





e Customize and extend the capabilities of any Macintosh computer 

e No programming experience needed! 

e Learn to use scripts to enhance the Macintosh environment, automate many 
processes, link data between applications, and much more 

e All-new examples showing how to integrate AppleScript with the Finder, 
spreadsheets, desktop publishing programs, graphics applications, databases, 
telecommunications programs, utilities, and HyperCard 

e Includes 31/2" disk with over $100 worth of software, including AppleScript 1.1, 
valuable utilities, and powerful, ready-to-use scripts 


List $39 Our Price (BDGASHB) 
SEE RELATED CATEGORY: Scripting, Tools, Libs & Utilities 
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Applied Mac Scripting 
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| | by Tom Trinko e Harness the capabilities of a wide variety of Macintosh 
4 e Learn to design and develop powerful scripts applications into the integrated productivity tools. 
4 e Covers AppleScript™ , Frontier, QuicKeys, Tempo II, nShell, e This includes such things as the newspaper script which 
: FaceSpan Application Builder, Scripting PlainTalk and System 7.5 combines the power of SlTcomm, MacWrite Pro, and 
| a e Hands on tutorial shows you how to automate your FileMaker Pro, or QuarkXPress 
= Macintosh activities by learning how to use the AppleScript List $34.95 Our Price (BAPPLIED) 
: and Frontier scripting environments SEE RELATED CATEGORY: Scripting 


1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 





pwerPC Programmer's Toolkit 
Tom Thompson 


JD-ROM includes a special version of Metrowerks 
CodeWarrior 7.0 and sample code from the book 
Jetails how to write PowerPC applications in native 
code for blazing speed (call for details 
Written by an Apple Insider 


List $45 Our Price (SPPCPT) 





Network Frontiers Bundle 

by AP PROFESSIONAL 

Includes 3 books: 

Complete Guide to MAC,Backup Management, 
Designing AppleTalk Network Architectures, and 
Managing AppleShare and Workgroup Servers 


lastering Netscape 2.0 for Macintosh, 2nd Ed. 
/ Greg Holden 


CD-ROM includes Netscape Plug-Ins and helper applications 

Uncovers hidden features of the program and how to best utilize them 

Web page for the book includes cool utilities and updated information 

List $40 Our Price (SMASNET4) 

e Apple Certified 

e Each bundle includes the first 3 books 
that correspond to the Apple 

e Certified Server Engineer (ACSE) program 


List $89.95 Our Price (BNETFB) 


Object Oriented Program Design 
by Mark Mullin 


e A concise guide to the essential concepts and techniques of OOP design 

e Clarifies the Key concepts of object oriented programming such as objects, classes, 
entities, hierarchies, and inheritance 

e Uses typical database application to illustrate each OOP topic, to give the programmer 
a familiar point of reference 7 





List $22.95 Our Price (BOOPRODES) 

ntranet Web Development: DeBabelizer: The 

nterprise Alternatives to Client/Server Computing Authorized Edition 

'y Hayden Development Team by Hayden Development Team 

» Learn why traditional client/server computing is being replaced by new e Teaches effective ways to utilize DeBabelizer 
WWW technologies to improve graphic’s quality and speed 

» Discusses WWW application development with the Microsoft Visual * Offers techniques for using SuperPallette 
script enterprise application developer in mind to optimize IMages | 

» Learn techniques for the conversion of existing Visual Basic, C++ and * Provides extensive visual examples to illustrate 
PowerBuilder Applications to the new WWW platform key production techniques in all areas of graphics 
List $49.99 Our Price (BINTWD) peor ud 


e CD-ROM includes the Lite version as well as 
Photoshop plug-ins 
List $45 Our Price (BDEBTAE) 
Tog on Software Design 
by Bruce “Tog” Tognazzini 
Respected industry futurist, Tog, presents his vision of our technological future, 
detailing the steps computer professionals need to take to deliver new technologies 
that will profit the industry and benefit society in general. Contains Tog’s insights on 
a wide range of topics from quality management to the meaning of standards, and 
responses to queries supplied by designers and developers. 


List $29.95 Our Price (BTOG) 
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3D Graphics Programming 


With QuickDraw 3D 3D Graphics Programming < 


Using QuickDraw 3D 
by Apple Computer, Inc. 


the Mac OS for Power Macintoshes 


viewing engine. Book/CD-ROM, 640 pages 
List $39.95 Our Price 


Sex, Lies and Video Games 
by Bill Hensler 








and interaction techniques 

e A must-read for serious programmer’s and 
hobbyists alike 
List 34.95 Our Price (BSEX) 
SEE RELATED CATEGORY: Tools, Libs & Utilities 
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Tricks of The Mac Game 


Programming Gurus 
by McCornack, Ragnemalm, Celestin, et al. 


e For beginning to expert game programmers 

¢ Complete overview of all the necessary 
components of game programming on the 
Macintosh 

e Packed with valuable tools, utilities, sample 
code, CodeWarrior™ Lite and game demos 

¢ QuickDraw 3D and Power Mac optimization 
and inside info on how Glypha Ill was created 

e Hundreds of tried-and-true tricks, tips, and 
insider secrets from well-known Mac game 
programming experts 
List $50 Our Price 
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Black Art of Macintosh Game Programming 

by Kevin Tieskoetter 

¢ Develop your own 3D games in C on the Mac 

e Includes CD with project files for both Symantec C and Code Warrior 

e Create freeform texture-mapped games and polygon graphics 

¢ Control dynamic source code- all compatible as native to the Power Mac 
e Write directly to the screen, bypassing QuickDraw 


List $39.99 Our price (BBLACK) 
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e Incorporate spectacular 3D graphics into your applications 
e Explore QuickDraw 3D, a revolutionary graphics extension to 


¢ CD contains the complete QuickDraw 3D system itself and 
a complete database of the QuickDraw 3D API, allowing you 
instant access to the hundreds of graphics calls via a fast 


(B3DGRAP) 


e A learn-by-example tutorial on the ins and outs 
of Mac arcade-style game programming in C 
e Features game theory, sprite animation, sound, 











3D Graphics-Tips, 
Tricks, & Techniques 
by David Kalwick 


e Written from a user’s point-of-view, this book 
covers all the important 3D techniques includi 
lighting, textures, animation, camera angles, a 
perspectives 

e Through easy-to-understand examples you'll | 
how to create high-quality 3D graphics 

e Includes a Windows/Macintosh CD-ROM featu 
tutorials, 3D examples from the book, and mo 


List 34.95 Our Price (B3DGTTT) 
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Graphic Gems V 
Edited by Alan W. Paeth 


e Loaded with practical tools for implementing 
new ideas and techniques, to offer working 
solutions to real programming problems 

e Contains over 40 new gems in ellipses, splines, 
Bezier curves, and ray tracing — displaying the 
most recent and innovative techniques in graphics 
programming 

e Includes a disk with source code from all five 





volumes 
e Available in both IBM and Macintosh versions 
¢ CONTENTS: Advanced Color Imaging on 
Algebra and Arithmetic Computational Geometry, the Mac 0S 
Modeling and Transformation, Curves and Surfaces, 
Ray Tracing and Radiosity, Halftoning, Image by Apple Computer, Inc. 
Processing, and Utilities e Enhance your software’s color capabilities 
List $49.95 Our Price (BGEMS5) with step-by-step instructions | | 
e Augment the color support supplied with 
AppleGuide Complete QuickDraw, and QuickDraw GX 


e Use the Pallette Manager to get the best 
colors on limited displays 

e atch colors between screens and 
input/output devices (scanners & printers) 

e CD includes a complete reference infor- 


by Apple Computer, Inc. 


e Covers Guide Maker, the software you use to 
build and test guide files 
e Learn about the complete cycle of designing 





as well as advanced topics such as scripting mation in both QuickView and Acrobat 
and coding guide files formats. Plus, a sample application 

¢ Book/CD-ROM, 544 pages demonstrating ColorSync programming 
List $39.95 Our Price (BAPLGD) techniques 
SEE RELATED CATEGORY: Tools, Libs & Utilities List $36.95 Our Price (BADVC)) 


penDoc Programmer’s Cookbook 
Apple Computer, Inc. 


Shows you how to create OpenDoc software components, called parts editors, for the Mac OS Platform 
ncluding instructions for setting up the Macintosh Programmers Workshop (MPW) development 
snvironment to write OpenDoc software 

Annotated listings of explaining the methods that implement the SamplePart part editor 
Descriptions of other sample part editors created by the OpenDoc engineering team to illustrate 
more advanced features 

Summary descriptions of software utilities provided with OpenDoc for the Mac OS 

An Introduction to the System Object Model (SOM) technology underlying OpenDoc 


List $24.95 Our price (BODCOOK) 





1iside PowerPlant Manual 
1 Metrowerks 


Create PowerPlant applications using the CodeWarrior 

IDE and PowerPlant Constructor 

Full descriptions of major PowerPlant classes and resources 
Included are the PowerPlant Constructor Manual, including View, 
TextTraits and Custom Types editing, and PowerPlant Library 
Reference, covering all classes and functions in PowerPlant 


Our Price (BINSPP) 
SEE RELATED CATEGORY: Dev. Environment 


ResEdit Complete, 
Second Edition 
by Peter Alley and Carolyn Strange 


e Customize every aspect of your interface form 
creating screen backgrounds and icons to 
customizing menus and dialog boxes 

© Book/disk package, 608 pages 


List $34.95 Our Price (BRESED2) 
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C++ Programming with CodeWarrior 


by Jan L. Harrington 

e Beginning OOP for the Macintosh and Power Macintosh and Mac OS compatibles 

e Learn object-oriented programming techniques using C++ as the example lan- 
guage and Metrowerks and CodeWarrior as the example compiler 

e Enclosed CD contains example code from the book and a full-function 
Metrowerks CodeWarrior 


List $35.95 Our Price $32.35 (BCPPCW) 






OpenDoc Programmer’s Guide 
by Apple Computer, Inc. 


e The official reference for the implementation of OpenDoc on the Mac OS 

e Describes the component software revolution and explains how to develop for it on the 
Mac OS platform 

e Accompanying CD-ROM contains a complete reference to the OpenDoc programming 
interface, and an extensive collection of tested, reusable sample code 


List $44.95 Our Price $40.46 (eorenpoc) 


The ResEdit All Night Diner 

by David Ciskowski 

e An idea-filled menu and introduction to the joys of customizing software 

e Add personality to the Mac by customizing default icons, the text of menus and dialog 
boxes, Cursors, pointers and more 

e Disk features ResEdit, plus lots of sample resources 
List $24.95 Our Price $22.45 (BRESDINE) 
SEE RELATED CATEGORY: Dev. Environments 
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iat, 
y : : 
w C++ Programming with MacApp 
Sf, \ by David Wilson, Larry Rosenstein & Dan Shafer 
wt \ e Learn the secrets to unlocking the power of MacApp®, Apple’s development 
mae 
nel environment for C++ 
— e Learn to design complex windows and views using the ViewEdit tool 
wt | e Learn to support multipage text and grephics with only five lines of code 
zs \ e Learn to support Undo for menu commands and drawing operations that use 
| the mouse 
he al | 
oe List $34.95 Our Price $31.46 (cepmacap) ms ROsENSHE 
a \ SEE RELATED CATEGORY: Tools, Libs & Utilities alll 
| 
fetta, 
ae, 
apr ; : : 
ff, Essential OpenDoc Inside CodeWarrior 11 
pee ) by Jesse Feiler and Anthony Meadow by Metrowerks 
oe e Gives an in-depth look at the technical issues of OpenDoc e Includes CodeWarrior IDE User’s Guide 
s e Explores the three core technologies that support it’s e This is the printed version of the 
| functionality - SOM, OpenDoc’s storage mechanism, and documentation provided on the CD 
eo \ the Open Scripting Architecture (OSA) e Covers CodeWarrior, the debugger, 
to , e Also examines CyberDog, a set of OpenDoc part editors that and associated tools 
 * provides access to Internet services and offers compelling Our Price $34.95 (BINSCW) 
, pra ( example of the power of OpenDoc development SEE RELATED CATEGORY: Dev. Environment 
eae \ List $39.95 Our price $35.95 (BESOD) 
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Metrowerks CodeWarrior Programming 
by Dan Parks Sydow 


e Includes CodeWarrior Lite, and Full Coverage of PowerPlant™ 

e The best information on Metrowerks CodeWarrior, giving full 
coverage to the Gold Edition 

e CD includes Code Warrior Lite 


List $39.95 Our Price $35.95 (Bcweroc) 





Visual Programming with Prograph CPX 
by Scott B. Steinman and Kevin G. Carver 
e An introduction to the language and a guide for advanced users, 
for both Macintosh and Windows-based machines 
List $34 Our Price $30.60 (avisero) 
SEE RELATED CATEGORY: Dev. Environments 


The Power of Prograph CPX 
by Dan Shafer 


e Master the revolutionary graphical object-oriented programming language 

e Step by step course through three interrelated projects of increasing complexity 
e Learn Prograph language, CPX classes and object editors 

e Includes disk with all code in the book 


List $49.95 Our Price $19.95 (BDANPRO) 





Mastering the THINK Class Library 
by Richard Parker 


e Provides a thorough examination of Symantec's extensive Class Library 
and the Visual Architect 

e A complete description of the structure and operation of the TCL includes 
explanations of all code generated by the Visual Architect, any necessary 
custom code, and the operation of this code 

e Visual Architect tutorials provide you with a step-by-step approach for 
simplifying the development of complex Macintosh applications, 496 pages 


List $29.95 Our Price $26.95 (BMASTERTCL) 
SEE RELATED CATEGORY: Dev. Environments 





Danny Goodman’s Apple Guide Starter Kit 


by Danny Goodman and Jeremy Joan Hewes 


e Create your own Apple Guide databases quickly and easily, without having to learn a 
scripting language, write coded files, or use several different files and programs 

e Includes advice and tips on how to design a good Guide, from planning and creation 
through testing, revising, and indexing. Book/disk, 320 pages 


List $34.95 Our Price $31.46 encacsk) 





MacsBug Reference & Debugging Guide For MacsBug version 6.2 
by Apple Computer, Inc. 


e MacsBug is an assembly-language-level debugging tool 

e Macros, templates, dcmds, and other resources for making debugging easier 

e Macintosh memory management and the operating system as they relate to low level debugging 

e How to display and set memory and process registers, disassemble memory, and set execution breakpoints 

e Discipline, a tool for testing the validity of toolbox parameters, debugging strategies to find & cure common bugs 
e Includes MacsBug 6.2 


List $34.95 Our Price $31.46 @puGREA 
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Netscape Navigator 3.0 
by Bryan Pfaffenberger 


e Learn the best Web surfing techniques 

e Quickly find your way to valuable information on the Web 
e Learn to use the new plug-in tools, including Live3D and Real Audio 
e Send and receive electronic mail to anyone on the Internet 

e Utilize the enhanced security features for on-line shopping and ordering 


List $29.95 Our Price $26.96 (BNETN3) 








Programming For The Newton: Software 

Development using NewtonScript 

by Julie McKeehan and Neil Rhodes. Foreword by Walter R. Smith 

e An indispensable tool for Newton programmers 

e Includes disk with sample Newton application from the books, as well 
as demonstration version of Newton Toolkt (NTK) — the complete 
development environment for the Newton® 

e A Publication of AP Professional May 1994, Softcover, 393 pages 
List $29.95 Our Price $26.96 (BPROGNEWT) 
SEE RELATED CATEGORY: Dev. Environments 


ES > 
Serve Mac, PC, and UNIX" machines 
on an Intranet with the Macintosh 


INTRANET 





Building and Maintaining 


an Intranet with the Macintosh 
by Tobin Anthony 


e Set up Services such as video conferencing, Real Audio 
message boards, employee scheduling, e-mail, WWW, f 
and many more 

e Find a simple, cost-effective solution to providing corpo 
information to company employees 

e Learn how to open portions of your intranet site up to tt 
internet while keeping private information safe 

e Companion CD-ROM 


List $50 Our Price $45 (BBAMA\) 


BASIC for the Newton 
by John Schettino & Liz O’Hara 


e Program on Macintosh, Windows-based PC, or on the Newton itself 

e Straight-forward “programming by example” approach — you'll be 
writing Newton programs right away 

e Includes 3.5" disk containing Demonstration NS BASIC and over 
fifty example programs (Newton not included) 


List $35.95 Our Price $32.35 (NEW) 
SEE RELATED CATEGORY: Dev. Environments 





Netscape Navigator Starter Kit for Macintosh 

by MacMillan 

e Create your own home page in minutes and add hyperlinks to your favorite web sites 
e Add graphics, audio, and video 

e Download files via FTP 

e Load plug-ins to enable movies, audio, animations, and more 


List $34.99 Our Price $31.49 (BNETNSK) 





Web Page Scripting Techniques 

by MacMillan 

e Manipulating color effectively 

e Placing images and using shapes 

e Using JavaScript functions and objects, plus VBScript functions and objects 
e Determining users browser type and operating system 


List $50 Our Price $45 (BWEBPST) 


SCRIPTING TECHNIQNES 
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Internet Publishing with Adobe Acrobat 

by MacMillan 

¢ Optimizing PDF for Web viewing, integrating HTML and PDF. 
selecting PDF page dimensions, PDF file evaluation 

¢ Setting links to PDFs and URLs, PDF forms, Security algorithms, 
Configuring Web servers for PDF, Embedded PDFs, PDF creation 
techniques 


List $40 Our Price $36 (BIPWAA) 





Providing Internet Services 
via the MacOS 


by Carl Steadman and Jason Snell 

e Shows you how to provide Web pages, FTP, 
Gopher, e-mail, and more with the Mac OS 

e Includes CD-ROM containing all the Mac 
server software and utilities you need 


List: $34.95 Our Price $31.46 (@PROVNET) 





Learn Java on the Mac 
by Barry Boone with Dave Mark 


e Easy-to-follow introduction for beginning 
programmers and Webmasters 

e Takes you through the core concepts of Java 

e Includes: Object-oriented techniques, unique 
features such as garbage collection, and 
basic programming concepts such as 
working with variables, threads and classes 

e Learn to apply this knowledge to writeoriginal 
Java applets for Web pages 

e Includes CD-ROM 


List: $34.95 Our Price $31.45 @Luava) 
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Learn HTML on the Mac 


by Dave Mark and David Lawrence 


e Shows you how to use HTML 3.0 
e Included CD-ROM contains Macintosh tools to 
design stunning multimedia Web pages 


List: $29.95 Our Price $26.95 @LHTML) 
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2lopment Environments Hardware -_ 
Script Applications: Building Applications w/FaceSpan BAPSCAP $31.45 Apple CD-ROM Handbook BCDHAND 14.36 i SOs 
for the Newton - Programming using NS BASIC BNEWT 32.35 Designing Cards & Drivers for the Macintosh BCARD 26.96 al 
Programming with CodeWarrior BCPPCW 32.35 LaserWriter Reference BLASERREF 17.96 : ) Bid 
+ SDK User’s Guide BCPPUSER 29.00 PCI System Architecture 3rd Edition BPCISYS 31.46 L ' 
Narrior Inside PowerPlant BINSPP 34.95 PowerPC System Architecture BPPCARCH 31.46 / me 
Narrior Software Development using PowerPlant BCWSWDEV 31.45 | 2% 
shafer Presents the Power of Prograph CPX BDANPRO 19.95 Internet Related | a 
RAN SDK User’s Guide BFORTUSER 34.95 1994 Internet White Pages BO4WHITE 26.95 pel 
: CodeWarrior Book BINSCW 34.95 Active Java BACTJAVA 23.36 : oss 
esort Programmers Edition BLSTRSRT 74,95 America Online for Dummies BAOLDUM 17.95 : 
| C on the Macintosh, 2nd Edition BLEARNC2 31.45 CGI By Example BCGIBE 31.45 ' 6 
aring the Think Class Library BMASTERTCL 26.95 Computer Privacy Handbook BPRIV 22.45 ‘A 
ywerks CodeWarrior Programming BCWPROG 35.95 E-Mail Essentials BEMAILE 22.45 i (= 
tive-C - Object-Oriented Programming BOBJCOOPT 34.15 Elements of E-Mail Style BEMAIL 13.45 : ] a. 
snting Magic Cap BPRESMAGIC 15.25 Hooked on Java BHJAVA 26.95 | eage 
amming for the Newton Using NewtonScript BPROGNEWT 26.95 Instant Internet Guide BINSTANT 13.45 : fa 
World Apple Guide BREALWLD 35.95 Internet Book BTHENET 22.50 : baad 
intec C++ Programming BSYMCPP 39.50 Internet for Dummies 2nd Edition BNETDUM2 17.99 ' { ad, 
ant’s Guide to Designing Programs BTALIGENT 17.55 Internet for Dummies Quick Reference BDUMQCK 8.05 ' ) 
il Programming with Prograph BVISPRO 30.60 Internet for Macs for Dummies BNETDUM 17.95 
ess For The Newton BWIRELESS 31.45 Internet for Macs for Dummies Bestseller Edition BIFMFDBE 35.99 i 











Internet Power Tools BPWRTOOL 36.00 Macintosh Programming Techniques BPTECH : 
Internet Publishing with Adobe Acrobat EIPWAA 36.00 More Mac Programming Techniques BMORETECH 
Internet Secrets ESECRET 35.99 Network Frontiers Bundle BNETFB § 
Internet, The, Deluxe Edition ENETDELUX 31.50 Nextstep Development Tools & Techniques BNEXTDTT , 
Intranet Web Dev.: Enterprise Alternatives to Client/Server EINTWD 44,99 NexTStep Development Tools & Techniques BNEXTDTT , 
Java Essentials for C/C++ Programmers BJAVAESSEN 17.95 NexTStep General Reference BNEXTGR é 
Java in a Nutshell BJAVANUT 13.45 NexTStep Operating System Software BNEXTTOSS , 
Java Language API SuperBible BJLAS 53.99 NexTStep Programming Interface Summary BNEXTPIS y 
JavaScript for Macintosh BJAVASCRPT 40.50 NexXTStep User Interface Guidelines BNEXTUIG d 
Learn HTML on the Macintosh BLHTML 26.95 Newton Programming Guide BNEWTPGUID é 
Learn Java on the Macintosh BLJAVA 31.45 Object Oriented Programming Design BOOPRODES d 
Mastering Netscape 4.0 for Macintosh, Second Edition BMASNET4 36.00 Optimizing PowerPC Code BOPTPPC d 
More Internet for Dummies Starter Kit BDUMNET 17.95 PostScript Language Reference BPSLANREF y 
Mosaic for Dummies BMOSDUM 17.99 Powerbook: Digital Nomad’s Guide BPBTDNG Z 
Net Chat BNETCHAT 17.00 PowerPC Programmer's Toolkit BPPCPT U 
NetObjects Fusion Handbook BNETOFH 45.00 Programming Introduction to the Macintosh Family BFAMILY Z 
Netscape Navigator BNETNAV 26.95 Programming for System 7 BSYS7 2 
Netscape Navigator Starter Kit BNETNSK 31.49 Programming Primer Macintosh Volume 1 BPRIMMAC Es 
Perl Quick Reference BPERLREF 17.99 Programming QuickDraw BPROQDRAW 2 
Planning and Managing Web sites BPLANWEB 35.96 Programming Starter Kit BPROSTART 4 
Providing Internet Services BPROVNET 31.46 Programming with AppleTalk BPROAT 2 
Publish it on the Web BWEBPUB 31.46 QuickTime - Official Guide for Macintosh Users BQTGUIDE 4 
TCP/IP Vol 1-Vol 2 Bundle BTCP12BNDL 99.00 QuickTime Starter Kit for the Macintosh BQTSKIT 4 
Teach Yourself Java in 21 days BJAVAMAC 36.00 Real World Apple Guide BREALWLD 3 
Underground Guide to Telecommuting BUNDER 22.45 ResEdit All Night Diner BRESDINE 2 
Web Head Mac Guide BWEBHEAD 22.45 ResEdit Complete, 1st Edition BRESED1 3 
Web Page Scripting Techniques BWEBPST 45.00 ResEdit Complete, 2nd Edition BRESED2 a 
Web Weaving BWWEAV 22.45 ResEdit Reference BRESEDREF 2 
Webmaster Macintosh BWEBMAS 26.95 Software by Design: Creating User Friendly Software BDESIGN 2 
Symantec C++ for the Macintosh: The Basics BSCFTMTB 3 
Scripting and Solutions Teach Yourself Macintosh C++ in 21 Days BCPP21D 2\ 
AppleScript Applications: Building Apps with FaceSpan BAPSCAP 31.45 Technical Introduction to the Macintosh Family BTITTMF 2: 
Applied Macintosh Scripting BAPPLIED 31.45 Tog on Software Design BTOG 2l 
Complete AppleScript Handbook BAPLSCRHB 31.50 Wireless for the Newton Development for Mobil Comm. BWIRELESS a 
Complete HyperCard 2.2 Handbook BHYPCRD2 31.50 Writing Localizable Software BLOCAL 2 
\ I Danny Goodman's Apple Guide Starter Kit BDGAGSK 31.46 
wt \ i Danny Goodman's AppleScript Handbook BDGASHB 35.00 Miscellaneous 
ae | HyperCard Stack Design BHYPSTA 19.95 Adobe Premiere for the Macintosh BPREM 4e 
i | HyperTalk 2.2: The Book BHYPTAL 31.50 America Online for Dummies BAOLDUM 17 
pm. \ Javascript for Macintosh BJAVASCRPT 40.50 Art of Human Interface Design BAHID 2! 
Sf”, \ / Perl Quick Reference BPERLREF 17.99 CD-ROM Guide to Multimedia Authoring BCDMULTI A( 
iw \ : Real World Apple Guide BREALWLD 35.95 CompuServe for Dummies BCSDUM 1] 
ae! Creating Interactive CD-ROM BINTERCDR 3% 
saad Technical Reference Cyberpunk Handbook BCYBPUNK é 
igs ‘ Active Java BACTJAVA 23.36 Danny Goodman’s Macintosh Handbook BGOODHB 2e 
eat, \ Apple CD-ROM Handbook BCDHAND 14.36 eWorld: The Essential Guide BEWORLD ¢ 
ame Art of Human Interface Design BAHID 29.65 FrameWorks Source Code Disk MTFWSC g 
Black Art of Mac Game Programming BBLACK 35.99 FrameWorks Magazine Back Issue MTFWBACK € 
pa C++ for Dummies 3CPPDUM 17.95 Global Interface Design BGLOBAL Z 
ae C for Dummies Vol. 1 3CDUM 17.95 Graphic Gems 2 BGEMS2 Ad 
ae, \ / Developing Object Oriented Software for the Macintosh 3DEVOB 26.06 Graphic Gems 4 BGEMS4 4é 
\, : Essential OpenDoc 3ESOD 35.95 Graphic Gems V BGEMS5 44 
Ate, Extending the Mac Toolbox 3ETMT 22.46 Infini-D Revealed BINFDREV 40 
— Foundations of Macintosh Programming 3FOUND 35.96 Late Night with MacHack BLATE 26 
Sf” Fragment of Your Imagination 3FRAG 35.96 Mac Bathroom Reader BBATH 11 
- \ Guide to Macintosh Software Localization 3LOCALIZ 24.26 Mac Screamer: The Ultimate Macintosh Supercharging Kit BSCREAM A 
—~y | Guide to Macintosh System 7.5 BSYS/.5 22.50 Macintosh Crash Course BCRASH 26 
How to Write Macintosh Software 3WRITE 26.05 MacTech Back Issues MTBACKISS 10 
6 9 Inside AppleTalk BAPTALK 31.45 Macworld Ultimate Macintosh Book BULTMAC Ri 
hg Inside the Macintosh Communications Toolbox BCOMM 22.45 Managing AppleShare & Workgroup Servers BMAWS 26 
jae \ LaserWriter Reference BLASERREF 17.96 MADACON ‘93 CD-ROM SMADA93 9 
a, q Learn C++ on the Macintosh BLRNCPP 35.05 Multimedia Authoring: Building and Developing Documents BMMAUTH 31 
ee Learn C on the Macintosh, 1st Edition BLEARNC1 31.45 Multimedia Starter Kit for Macintosh BMMSTART 27 
wm, Learn C on the Macintosh, 2nd Edition BLEARNC2 31.45 Profit from Experience BPROFIT 22 
od : Mac Programming for Dummies BMACDUM 17.95 Sad Macs, Bombs and Disasters BSADMAC 22 
amet’, \ Macintosh C Programmer Primer Volume 1 BCPRIM1 24.25 Sex, Lies & Video Games BSEX 31 
ite { Macintosh C Programmer Primer Volume 2 BCPRIM2 24.25 Stupid Mac Tricks BSTUPIDMAC 47) 
Macintosh OLE2 Prog. Reference Working with Objects BOLE2 40.45 The Software Developer's & Marketer’s Legal Companion BSDAMLC 33. 
Macintosh Pascal Programming Primer Volume | BPASCPRI 24.25 Tricks of the Mac Game Gurus BTRICKS 45. 
Macintosh Programming Secrets BPSECRET 28.76 Zen and the Art of Resource Editing BZAAORE 27. 
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Unlock the power of 
PowerPC microprocessors. 


Motorola's optimizing C/C++ SDK, PowerPC™ Edition for Mac OS, is designed specifically for developers creating applications 
and tools for computer systems running Mac'™ OS. The Motorola compiler works with Metrowerks CodeWarrior, Symantec 
Project Manager and Apple Macintosh Programmer's Workshop (MPW®) to offer a powerful set of development tools within a 
complete development environment. 


The SDK features the Kuck & Associates Preprocessor (KAP'“) — a powerful code restructuring tool designed to improve 
performance across a broad range of application programs. The Motorola C/C++ SDK delivers world-class code optimization 
for any specific PowerPC microprocessor, while ensuring compatibility across the entire PowerPC family of microprocessors. 


To find out how Motorola can help you unlock the power of PowerPC microprocessors, visit our web site at 
http://www.mot.com/PowerPC/ or call us at 1-800-345-8384 or 1-512-891-2229. 
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